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
| Ferramenta | O que faz |
|---|---|
chat_with_agent | Envia 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_modules | Lista os módulos de CRM no workspace |
list_module_fields | Lista os campos de um módulo — útil antes de criar/atualizar registros |
list_records | Lista registros em um módulo com busca + paginação |
get_record | Obtém um único registro por ID |
create_record | Cria um novo registro |
update_record | Atualiza os campos de um registro |
delete_record | Exclui um registro de forma suave (recuperável da lixeira) |
list_outreach_items | Lista artigos de blog, posts do LinkedIn, e-mails etc. |
get_outreach_item | Obtém um único item de outreach, incluindo seu conteúdo MDX |
create_outreach_item | Cria um novo item de outreach |
update_outreach_body | Atualiza o corpo MDX de um item de outreach |
update_outreach_item | Atualiza 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ável | Obrigatória | Padrão | Descrição |
|---|---|---|---|
COHERENCE_API_TOKEN | Sim | — | Chave de API (sk_live_…) do seu workspace Coherence |
COHERENCE_API_URL | Não | https://api.getcoherence.io/v1 | URL 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óduloscollab:read,collab:write— documentos Collabagents:read,agents:write— agentes echat_with_agentworkspace: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
- Coherence: https://getcoherence.io
- Página de destino do MCP: https://getcoherence.io/mcp
- Documentação e início rápido: https://getcoherence.io/docs/mcp/quickstart
- Documentação da API (OpenAPI): https://api.getcoherence.io/v1/openapi.json
- Problemas: https://github.com/getcoherence/mcp-server/issues