Coherence

Converse com o agente de IA do seu CRM a partir do Claude, Cursor e outros clientes MCP — leia registros, envie e-mails, crie lembretes, elabore contatos, tudo controlado por aprovações.

Documentação

@coherenceos/mcp-server

Servidor MCP (Model Context Protocol) que expõe o Coherence como ferramentas para Claude, Cursor, Cline e outros clientes compatíveis com MCP.

O destaque: chat_with_agent — envie uma mensagem para seu agente Coherence (Nash) pelo Claude Desktop e ele pode redigir e-mails, criar lembretes, atualizar registros, publicar em redes sociais, criar landing pages e muito mais, tudo sob as regras de aprovação do seu workspace.

Início rápido

1. Crie uma chave de API

No Coherence, vá em Configurações → Chaves de API → Criar nova chave. Copie o valor de sk_live_… — ele é exibido apenas uma vez. A interface do Coherence fornecerá um snippet JSON pronto para colar, que você pode inserir diretamente na configuração do seu cliente MCP.

2. Adicione ao seu cliente MCP

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json no macOS, %APPDATA%\Claude\claude_desktop_config.json no Windows):

{
  "mcpServers": {
    "coherence": {
      "command": "npx",
      "args": ["-y", "@coherenceos/mcp-server"],
      "env": {
        "COHERENCE_API_URL": "https://api.getcoherence.io/v1",
        "COHERENCE_API_TOKEN": "sk_live_..."
      }
    }
  }
}

Cursor / Cline / Continue / Windsurf: o mesmo JSON, inserido no arquivo de configurações MCP de cada ferramenta.

3. Fale com seu workspace

Reinicie seu cliente MCP e tente:

"Peça ao meu agente Coherence para redigir um e-mail de acompanhamento para os leads que criei esta semana."

"Liste meus negócios abertos acima de $50k."

"Crie um contato para Jane Doe na Acme Corp e me lembre de fazer o acompanhamento na próxima terça-feira."

Ferramentas disponíveis

FerramentaO que faz
chat_with_agentEnvia uma mensagem a um agente Coherence; o agente usa seu próprio conjunto de ferramentas (e-mail, lembretes, calendário, redes sociais, landing pages, aprovações etc.) e retorna sua resposta
list_modulesLista os módulos de CRM no workspace
list_module_fieldsLista os campos de um módulo — útil antes de criar/atualizar registros
list_recordsLista registros em um módulo com busca + paginação
get_recordObtém um único registro por ID
create_recordCria um novo registro
update_recordAtualiza os campos de um registro
delete_recordExclui um registro de forma suave (recuperável da lixeira)
list_outreach_itemsLista artigos de blog, posts do LinkedIn, e-mails etc.
get_outreach_itemObtém um único item de outreach, incluindo seu conteúdo MDX
create_outreach_itemCria um novo item de outreach
update_outreach_bodyAtualiza o corpo MDX de um item de outreach
update_outreach_itemAtualiza os metadados de outreach (título, status etc.)

Para todo o resto — eventos de calendário, envio de e-mail, publicação em redes sociais, criação de landing pages, gerenciamento de aprovações — use chat_with_agent. O agente tem o conjunto completo de ferramentas.

Variáveis de ambiente

VariávelObrigatóriaPadrãoDescrição
COHERENCE_API_TOKENSimChave de API (sk_live_…) do seu workspace Coherence
COHERENCE_API_URLNãohttps://api.getcoherence.io/v1URL base da API

Escopos

Ao criar uma chave de API no Coherence, você pode escolher escopos. Se você não marcar nenhum, a chave herda todas as suas permissões de usuário (o padrão). Se você marcar alguns, a chave fica restrita a eles:

  • records:read, records:write — registros de módulos
  • collab:read, collab:write — documentos Collab
  • agents:read, agents:write — agentes e chat_with_agent
  • workspace:read — módulos, campos, metadados do workspace

As barreiras de aprovação (sendEmail, postToSocial etc.) são aplicadas dentro da plataforma Coherence independentemente dos escopos que uma chave possua — uma chave de API não pode contorná-las.

Links