Circleback MCP

Conecte outros apps de IA, como ChatGPT, Claude, Cursor e outros, ao Circleback

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 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, 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 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. 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 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 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.

Artigos relacionados