# Circleback MCP (/docs/pt/support/platform/circleback-mcp)

O servidor Model Context Protocol (MCP) do Circleback oferece uma interface padronizada que permite que qualquer app de IA compatível, como Claude e ChatGPT, acesse seus dados do Circleback de forma simples e segura.

Depois de conectado, seu assistente de IA pode pesquisar e acessar suas reuniões, e-mails, eventos de calendário e mais, tudo sem sair do seu app de IA. Isso elimina a necessidade de copiar e colar entre o Circleback e outros apps de IA.

O servidor MCP segue a [especificação MCP](https://modelcontextprotocol.io/specification/2025-03-26) remota autenticada, então o servidor é hospedado e gerenciado de forma centralizada.

## Configuração

### Geral

O servidor MCP do Circleback é compatível com transportes Streamable HTTP. Ele usa OAuth para autenticação em [`https://circleback.ai/api/mcp`](https://circleback.ai/api/mcp), com registro dinâmico de clientes ou documentos de metadados de ID do cliente.

Os administradores do espaço de trabalho também podem configurar a [Autorização gerenciada pela empresa](/docs/support/security/enterprise-managed-authorization) para gerenciar o acesso dos membros ao Circleback MCP pelo provedor de identidade.

### Claude⁠

1. Acesse **Settings** pela barra lateral na web ou no desktop
2. Selecione **Connectors** na barra lateral das configurações e clique em **Browse connectors**
3. Pesquise Circleback e clique em **+** para conectar

### ChatGPT

Conecte o app do Circleback para ChatGPT [aqui](https://chatgpt.com/apps/circleback/asdk_app_695308f21c648191a0dd48dc9965f4bb). Depois de conectado, o ChatGPT consultará o Circleback automaticamente quando for relevante, por exemplo, quando você perguntar sobre reuniões ou conversas.

Você também pode adicionar o Circleback explicitamente na sua mensagem para garantir que ele seja usado.

### Raycast

Clique [aqui](raycast://mcp/install?%7B%22name%22%3A%22Circleback%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//circleback.ai/api/mcp%22%7D) para instalar o servidor MCP do Circleback no Raycast.

Na pesquisa raiz, em AI Commands ou no AI Chat, digite @circleback para mencionar e usar as ferramentas fornecidas pelo Circleback MCP.

### Claude Code

1. Abra o terminal e execute o seguinte comando
   ```
   claude mcp add --transport http circleback https://circleback.ai/api/mcp
   ```
2. Execute `/mcp` depois de abrir uma sessão do Claude Code para passar pelo fluxo de autenticação

### Cursor

Clique [aqui](https://cursor.com/marketplace/cursor/circleback) para adicionar o plugin do Circleback pelo Cursor Marketplace.

### Codex

As etapas de configuração são as mesmas, quer você use a extensão para IDE ou a CLI, já que a configuração é compartilhada.

#### Configuração pela CLI

1. Execute o seguinte comando no Terminal
   ```
   codex mcp add circleback --url https://circleback.ai/api/mcp
   ```
   Isso solicitará automaticamente que você faça login com sua conta do Circleback e a conecte ao Codex.\
   \
   **Observação**: se esta for a primeira vez que você usa um MCP no Codex, será preciso ativar o recurso `rmcp` para que isso funcione. Adicione o seguinte ao seu `~/.codex/config.toml`
   ```
   [features]
   experimental_use_rmcp_client = true
   ```

#### Configuração por variáveis de ambiente

1. Abra o arquivo `~/.codex/config.toml` no editor de sua preferência e adicione o seguinte

   ```
   [features]
   experimental_use_rmcp_client = true

   [mcp_servers.circleback]
   url = "https://circleback.ai/api/mcp"
   ```

2. Execute `codex mcp login circleback` para passar pelo fluxo de autenticação

## O que você pode fazer

O servidor MCP do Circleback tem ferramentas para pesquisar, ler e atualizar seus dados do Circleback, agrupadas abaixo pelo tipo de dado com que trabalham.

### Reuniões

- **SearchMeetings**: encontra reuniões por palavra-chave, intervalo de datas, tags, participante, domínio, propriedade ou pasta. Com uma palavra-chave, a primeira página também inclui reuniões cujas transcrições correspondem, e cada reunião lista os trechos correspondentes da transcrição, com marcações de tempo.
- **ReadMeetings**: obtém informações detalhadas de reuniões específicas, incluindo notas, suas notas privadas, participantes, itens de ação, insights, tags, pastas e duração.
- **UpdateMeeting**: atualiza o nome, as notas, suas notas privadas, as tags ou as pastas de uma reunião.
- **ShareMeeting**: compartilha uma reunião com uma pessoa, uma equipe, o espaço de trabalho ou qualquer pessoa com o link, ou remove o acesso.
- **DisplayMeetings**: mostra as reuniões selecionadas como cards que você pode clicar para abrir no Circleback, em apps de IA compatíveis com MCP Apps. Outros apps as recebem como texto.

### Transcrições

- **GetTranscriptsForMeetings**: obtém a transcrição completa de uma ou mais reuniões, com rótulos de falante e marcações de tempo.

### Itens de ação

- **SearchActionItems**: encontra itens de ação por palavra-chave, status (pendente ou concluído), responsável, tag, domínio ou intervalo de datas.
- **CreateActionItem**: cria um item de ação, opcionalmente com uma descrição ou vinculado a uma reunião. Ele é atribuído a você, a menos que você indique outra pessoa ou peça para deixá-lo sem responsável.
- **UpdateActionItem**: atualiza o título, a descrição, o status ou o responsável de um item de ação.
- **DeleteActionItem**: exclui um item de ação.
- **DisplayActionItems**: mostra os itens de ação selecionados como uma lista de verificação que você pode marcar como concluídos e reatribuir, em apps de IA compatíveis com MCP Apps. Outros apps os recebem como texto.

### Calendário

- **SearchCalendarEvents**: pesquisa eventos de calendário próximos e passados, incluindo participantes, links de reunião e status de participação.
- **UpdateCalendarEvent**: atualiza as notas privadas ou as tags de uma reunião antes que ela comece.
- **DisplayCalendarEvents**: mostra os próximos eventos de calendário como cards com uma chave para definir se o Circleback participa, em apps de IA compatíveis com MCP Apps. Outros apps os recebem como texto.

### E-mails

- **SearchEmails**: pesquisa threads nas contas de e-mail conectadas por palavra-chave, remetente, destinatário ou intervalo de datas.

### Pessoas e empresas

- **FindProfiles**: procura pessoas pelo nome para obter o e-mail, o cargo e a empresa delas.
- **FindCompanies**: procura empresas pelo nome ou domínio.

### Tags

- **ListTags**: lista todas as tags do seu espaço de trabalho, útil para filtrar reuniões, transcrições ou itens de ação.
- **CreateTag**, **UpdateTag**, **DeleteTag**: criam, renomeiam, mudam a cor ou excluem tags.

### Pastas

- **ListFolders**: lista as pastas que você pode ver no seu espaço de trabalho, com os IDs delas.
- **ReadFolders**: obtém os membros, as equipes e as regras de uma pasta.
- **CreateFolder**, **UpdateFolder**, **DeleteFolder**: criam, renomeiam, alteram as regras ou excluem pastas.
- **ShareFolder**: compartilha uma pasta com uma pessoa, uma equipe, o espaço de trabalho ou qualquer pessoa com o link, altera o acesso deles ou os remove.

### Espaço de trabalho

- **ListTeams**: lista seu espaço de trabalho e as equipes dele, com os IDs para compartilhamento.

### Suporte

- **SearchSupportArticles**: pesquisa a documentação de suporte do Circleback em busca de ajuda e guias de instruções.
- **SubmitFeedback**: envia feedback, um relatório de bug ou uma solicitação de recurso para a equipe do Circleback.

## Acesso de gravação

As ferramentas que fazem alterações, como criar ou excluir um item de ação, precisam de acesso de gravação. O Circleback solicita esse acesso quando você conecta, e seu app de IA ainda pode pedir que você confirme cada alteração. Se você conectou antes de essas ferramentas estarem disponíveis, desconecte e reconecte o Circleback no seu app de IA para conceder acesso de gravação.

Por padrão, a conexão concede acesso de leitura e gravação (`scope=user user:write`). Se o seu app precisar apenas de acesso somente leitura, passe `scope=user` na solicitação de autorização. Nesse caso, as ferramentas que fazem alterações retornam um erro pedindo que o usuário reconecte com acesso de gravação.