Coherence

@coherenceos/mcp-server

Servidor MCP (Model Context Protocol) que expone Coherence como herramientas para Claude, Cursor, Cline y otros clientes compatibles con MCP.

Lo más destacado: chat_with_agent — envía un mensaje a tu agente de Coherence (Nash) desde Claude Desktop y puede redactar correos, crear recordatorios, actualizar registros, publicar en redes sociales, crear páginas de destino y más, todo bajo las reglas de aprobación de tu espacio de trabajo.

Inicio rápido

1. Crear una clave de API

En Coherence, ve a Settings → API Keys → Create new key. Copia el valor de sk_live_… — solo se muestra una vez. La interfaz de Coherence te dará un fragmento JSON listo para pegar que puedes colocar directamente en la configuración de tu cliente MCP.

2. Agregar a tu cliente MCP

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS, %APPDATA%\Claude\claude_desktop_config.json en 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: el mismo JSON, colocado en el archivo de configuración MCP de cada herramienta.

3. Habla con tu espacio de trabajo

Reinicia tu cliente MCP y luego prueba:

"Pídele a mi agente de Coherence que redacte un correo de seguimiento a los clientes potenciales que creé esta semana."

"Lista mis negocios abiertos por más de $50k."

"Crea un contacto para Jane Doe en Acme Corp, y luego recuérdame hacer seguimiento el próximo martes."

Herramientas disponibles

Herramienta	Qué hace
chat_with_agent	Envía un mensaje a un agente de Coherence; el agente usa su propio conjunto de herramientas (correo, recordatorios, calendario, redes sociales, páginas de destino, aprobaciones, etc.) y devuelve su respuesta
list_modules	Lista los módulos de CRM en el espacio de trabajo
list_module_fields	Lista los campos de un módulo — útil antes de crear/actualizar registros
list_records	Lista los registros de un módulo con búsqueda + paginación
get_record	Obtiene un solo registro por ID
create_record	Crea un nuevo registro
update_record	Actualiza los campos de un registro
delete_record	Elimina suavemente un registro (recuperable desde la papelera)
list_outreach_items	Lista artículos de blog, publicaciones de LinkedIn, correos, etc.
get_outreach_item	Obtiene un solo elemento de divulgación, incluido su contenido MDX
create_outreach_item	Crea un nuevo elemento de divulgación
update_outreach_body	Actualiza el cuerpo MDX de un elemento de divulgación
update_outreach_item	Actualiza los metadatos de divulgación (título, estado, etc.)

Para todo lo demás — eventos de calendario, envío de correos, publicaciones en redes sociales, creación de páginas de destino, gestión de aprobaciones — usa chat_with_agent. El agente tiene el conjunto completo de herramientas.

Variables de entorno

Variable	Requerida	Predeterminado	Descripción
COHERENCE_API_TOKEN	Sí	—	Clave de API (sk_live_…) de tu espacio de trabajo de Coherence
COHERENCE_API_URL	No	https://api.getcoherence.io/v1	URL base de la API

Alcances

Cuando creas una clave de API en Coherence puedes elegir alcances. Si no marcas ninguno, la clave hereda todos tus permisos de usuario (el valor predeterminado). Si marcas algunos, la clave se restringe a esos:

• records:read, records:write — registros de módulos
• collab:read, collab:write — documentos de Collab
• agents:read, agents:write — agentes y chat_with_agent
• workspace:read — módulos, campos, metadatos del espacio de trabajo

Las compuertas de aprobación (sendEmail, postToSocial, etc.) se aplican dentro de la plataforma de Coherence independientemente de los alcances que tenga una clave — una clave de API no puede omitirlas.

Enlaces

• Coherence: https://getcoherence.io
• Página de destino de MCP: https://getcoherence.io/mcp
• Documentación y guía de inicio rápido: https://getcoherence.io/docs/mcp/quickstart
• Documentación de API (OpenAPI): https://api.getcoherence.io/v1/openapi.json
• Problemas: https://github.com/getcoherence/mcp-server/issues