CLI y editores

Customermates es el CRM de código abierto pensado para la IA. Una vez conectado, tu agente de programación lee y escribe contactos, oportunidades y notas sin salir de la terminal. Todos los clientes que se describen aquí se autentican igual: una clave de API en la cabecera x-api-key hacia <BASE_URL>/api/v1/mcp, donde <BASE_URL> es la dirección con la que abres Customermates, en la nube o en tu propia instancia. Los fragmentos de abajo ya llevan la dirección del sitio que muestra esta página; si abres Customermates en otra dirección, cámbiala además de YOUR_KEY.

Crea una clave de API

En Customermates, abre Claves de API y conectores, haz clic en Añadir y elige Clave de API estándar. Ponle el nombre del cliente (por ejemplo Claude Code); sin una fecha en Caduca en, nunca caduca. La clave de 64 caracteres se muestra una sola vez, así que cópiala de inmediato. Conexiones rápidas, en el mismo cuadro de diálogo, lo hace por ti: pone a la clave el nombre del cliente, la configura para que caduque a los 365 días y muestra el fragmento de configuración con la clave ya incluida y su caducidad debajo.

Crear una clave requiere Crear en la fila API y webhooks de tu rol, y la propia página necesita Acceso de lectura Todos en esa fila; el rol Administrador integrado tiene ambos. Una clave hereda los permisos del usuario que la creó; no hay ámbitos por clave. Crea una clave por cliente para poder revocar una sin tocar las demás; el registro de actividad anota el usuario al que pertenece una clave, no la clave en sí. Las claves de API y MCP funcionan en todos los planes y en las instancias autoalojadas. Detalles: Claves de API.

Claude Code

Claude Code añade servidores MCP desde su CLI. Un solo comando hace la configuración. Ejecútalo en cualquier terminal, sustituyendo YOUR_KEY:

claude mcp add --transport http customermates https://customermates.com/api/v1/mcp \
  --header "x-api-key: YOUR_KEY"

No hace falta reiniciar ni editar ningún archivo de configuración. Claude Code se conecta automáticamente. Ejecuta claude mcp list para confirmar que customermates aparece.

Ámbito: el comando usa por defecto el ámbito local. Añade --scope user para que Customermates esté disponible en todo tu equipo, o --scope project para escribirlo en el .mcp.json de un repositorio y que tus compañeros lo reciban.

Codex

Codex se conecta directamente a Customermates mediante Streamable HTTP. codex mcp add customermates --url <BASE_URL>/api/v1/mcp añade la URL del servidor, pero el comando de la CLI no tiene ninguna opción para una cabecera x-api-key personalizada. Para acceder con una clave de API, abre ~/.codex/config.toml (créalo si no existe) y añade el bloque completo de abajo, sustituyendo YOUR_KEY:

[mcp_servers.customermates]
enabled = true
url = "https://customermates.com/api/v1/mcp"
http_headers = { "x-api-key" = "YOUR_KEY" }

Para tomar la clave de tu entorno en lugar de guardarla en el archivo, sustituye la línea http_headers del bloque anterior por:

env_http_headers = { "x-api-key" = "CUSTOMERMATES_API_KEY" }

Después, exporta CUSTOMERMATES_API_KEY en el perfil de tu shell. Las sesiones nuevas recogen el servidor, así que termina la actual y empieza una nueva.

El mismo endpoint HTTP también acepta OAuth. Si prefieres iniciar sesión, añade la URL con codex mcp add customermates --url <BASE_URL>/api/v1/mcp y luego ejecuta codex mcp login customermates. El puente stdio que se describe más abajo es para los clientes de Claude Desktop que lo necesitan.

Cursor

Para configurar Cursor, abre Settings → Tools & MCP → Add new MCP server y pega esto, sustituyendo YOUR_KEY:

{
  "customermates": {
    "url": "https://customermates.com/api/v1/mcp",
    "headers": {
      "x-api-key": "YOUR_KEY"
    }
  }
}

Cursor recarga la configuración en caliente, así que no hace falta reiniciar. Las herramientas aparecen en Composer al momento. Para editar el archivo directamente, el mismo bloque va en ~/.cursor/mcp.json (global) o en <project>/.cursor/mcp.json (por proyecto), dentro de mcpServers.

Gemini CLI

Gemini CLI carga los servidores MCP desde ~/.gemini/settings.json. Combina esto con tu archivo, sustituyendo YOUR_KEY:

{
  "mcpServers": {
    "customermates": {
      "httpUrl": "https://customermates.com/api/v1/mcp",
      "headers": {
        "x-api-key": "YOUR_KEY"
      }
    }
  }
}

Si mcpServers ya tiene entradas, añade customermates junto a las existentes en lugar de sobrescribir el objeto.

Claude Desktop (archivo de configuración)

La vía recomendada para Claude Desktop es la vía del conector: OAuth, sin clave, sincronizada entre tus dispositivos. En un plan gratuito, o si prefieres una clave estática, el archivo de configuración de abajo también sirve.

Abre Claude → Settings → Developer → Edit Config, o el archivo directamente:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Combina esto con tu archivo, sustituyendo YOUR_KEY:

{
  "mcpServers": {
    "customermates": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://customermates.com/api/v1/mcp",
        "--header",
        "x-api-key:YOUR_KEY"
      ]
    }
  }
}

mcp-remote es un adaptador que permite a Claude Desktop hablar con un servidor MCP HTTP remoto mediante stdio. Se descarga la primera vez que se ejecuta con npx, así que necesitas Node 18+ en el PATH.

Después reinicia: sal por completo (⌘Q en macOS, no basta con cerrar la ventana) y vuelve a abrir. Customermates aparece en el panel de herramientas con las herramientas del CRM enumeradas.

Prueba tu primera petición

El servidor ofrece instrucciones de conexión que describen su superficie de herramientas, las reglas de seguridad y cómo recuperar las páginas relevantes de la Base de conocimientos. Cada cliente decide si pasa esas instrucciones a su agente. Si el tuyo no lo hace, añade la regla de recuperación de la Base de conocimientos a las instrucciones persistentes de ese cliente. En los clientes que admiten prompts de MCP (como Claude Code), puedes ejecutar el prompt integrado get-started para un arranque guiado: primero lee tu espacio de trabajo y las páginas relevantes de la Base de conocimientos y después pregunta solo por la información que falta.

• «Cambia el campo Estado de la oportunidad de Acme a "Ganada" y añade una nota de que el contrato se firmó hoy.»
• «Dame los últimos diez contactos que creé. ¿Alguno sin dirección de correo?»
• «Crea un contacto para Jane Doe en Initech, vincúlalo a la organización Initech y abre una oportunidad por 12 horas de consultoría.»
• «¿Qué conversaciones con clientes esperan mi respuesta? Redacta una respuesta a la más antigua y guárdala como borrador.»

La petición de respuesta necesita un canal conectado en Customermates Cloud a partir de Pro; el borrador espera en la conversación hasta que lo revises y lo envíes.

Cada espacio de trabajo define sus propios tipos de registro, como contactos, oportunidades o tareas, y atributos como la etapa de una oportunidad o la prioridad de una tarea dependen también de la configuración del espacio de trabajo. Llama a discover_record_types y después a get_record_model para obtener los ID de tipo relevantes antes de escribir.

Solución de problemas

Siguiente

• Conector personalizado: la vía OAuth para las aplicaciones de Claude y ChatGPT.
• Catálogo de herramientas MCP: todas las herramientas que el agente puede llamar.
• Webhooks: suscribe otros sistemas a los cambios del CRM.