Cómo conectar Claude a su CRM con MCP - Relaticle         

Cómo conectar Claude a su CRM con MCP
=====================================

Conecte Claude a Relaticle con OAuth o un token con alcance limitado. Entienda los campos personalizados, el descubrimiento de herramientas y la escritura directa antes de editar registros.

 Manuk Minasyan · 28 de agosto de 2026 · 15 min de lectura

 ![Cómo conectar Claude a su CRM con MCP](https://relaticle.com/storage/ink/01M7T45JDZDS6S2GZ289D3370T.png) 

Con Claude Code, puede hacer que Claude lea y escriba en su CRM de Relaticle en unos dos minutos. Conectar Claude.ai o Claude Desktop mediante OAuth toma unos minutos más. Una vez conectado, Claude puede buscar sus empresas, personas, oportunidades, tareas y notas y leer el detalle completo de cada registro. También puede crear, actualizar o eliminar registros directamente, con los mismos atributos personalizados que su equipo ya configuró. Esta es la guía de configuración: qué le ofrece realmente la conexión, cómo configurarla desde cada cliente y qué pueden hacer las herramientas disponibles. También explica lo que la mayoría de las guías omiten: cómo se comportan exactamente las escrituras una vez que Claude tiene acceso.

La referencia canónica de cada detalle que sigue está en [relaticle.com/developers/mcp](https://relaticle.com/es/developers/mcp). Esta publicación es el recorrido narrativo. Guarde esa página en sus marcadores para consultar los esquemas exactos de las herramientas y la solución de problemas.

[](#qué-le-ofrece-la-conexión "Permalink")Qué le ofrece la conexión
-------------------------------------------------------------------

[MCP (Model Context Protocol)](https://modelcontextprotocol.io/) es el estándar abierto que permite a un asistente de IA llamar a herramientas reales de un sistema real. Así no tiene que copiar datos una y otra vez entre una ventana de chat y su CRM. Relaticle ejecuta un MCP server en `mcp.relaticle.com` que expone su espacio de trabajo a cualquier cliente compatible con MCP.

Una vez conectado, Claude puede:

- Buscar y listar empresas, personas, oportunidades, tareas y notas, con filtros, ordenamiento y paginación
- Obtener un único registro con todo su detalle y sus relaciones (las personas de una empresa, las tareas vinculadas a una oportunidad, etc.)
- Crear, actualizar y eliminar de forma lógica (soft delete) registros de cualquiera de esos cinco tipos de entidad
- Leer y escribir los atributos personalizados de su espacio de trabajo, no solo los integrados
- Vincular o desvincular tareas y notas de empresas, personas y oportunidades, y asignar tareas a miembros del espacio de trabajo
- Leer un recurso de esquema por entidad para conocer los códigos de campo y los valores de opción exactos antes de escribir nada

Cada una de esas operaciones se limita a un único espacio de trabajo: el que usted eligió al autorizar la conexión. Con el mismo token, Claude no puede ver ni modificar los datos de otro espacio de trabajo.

[](#conectar-desde-claude-web-y-escritorio "Permalink")Conectar desde Claude (web y escritorio)
-----------------------------------------------------------------------------------------------

El MCP server de Relaticle admite dos métodos de autenticación, y el que use depende del cliente.

**OAuth (recomendado para Claude.ai, Claude Desktop y Claude Code).** Agregue Relaticle como conector personalizado con la URL del endpoint de MCP, `https://mcp.relaticle.com`, o con su propio dominio si usa alojamiento propio. El servidor admite OAuth 2.1 con Dynamic Client Registration, por lo que Claude se registra automáticamente. Luego le muestra una pantalla para aprobar la conexión con un clic. Usted elige el espacio de trabajo que usará este conector. Aprueba el acceso y queda conectado. No hay ningún token que copiar ni pegar.

Esa elección del espacio de trabajo es permanente para el conector. Si necesita apuntarlo a otro espacio de trabajo, revoque el conector y vuelva a conectarlo en lugar de intentar cambiarlo directamente. Los tokens de acceso emitidos de este modo duran 30 días y los tokens de actualización duran 90. Claude los renueva en segundo plano, así que una vez configurado no debería notar el vencimiento.

**Token de acceso personal.** Cree uno en la página Tokens de acceso de Relaticle, elija su espacio de trabajo y sus permisos, y copie el token. Para Claude Desktop, agregue este servidor remoto en **Customize → Connectors** (Personalizar, Conectores) con OAuth. El archivo `claude_desktop_config.json` de Claude Desktop es para servidores locales. Consulte [la guía de Anthropic para agregar un conector por URL](https://claude.com/docs/connectors/custom/add-unlisted).

![La página Tokens de acceso en la configuración de Relaticle, con el formulario de creación y la lista de conectores de IA](https://relaticle.com/storage/ink/01M09FZ68X5A12WNH2DFGVRMKC.png)

Las conexiones OAuth aparecen en **Tokens de acceso → Conectores de IA**, donde puede revocarlas. Los tokens de acceso personal aparecen en la lista de tokens de esa página.

**ChatGPT**, en pocas palabras: sus conectores personalizados también admiten OAuth Dynamic Client Registration. Por eso, el proceso de configuración es similar al de Claude.ai. Las herramientas `search` y `fetch` de Relaticle están diseñadas específicamente para combinarse con la función Company Knowledge de ChatGPT. `search` devuelve URL canónicas y `fetch` convierte una de esas URL de nuevo en un registro completo. Es exactamente el contrato que esa función espera.

[](#conectar-desde-claude-code "Permalink")Conectar desde Claude Code
---------------------------------------------------------------------

Claude Code se conecta mediante OAuth, igual que Claude.ai. Agregue el servidor y luego inicie sesión:

```
claude mcp add relaticle --transport http https://mcp.relaticle.com
claude mcp login relaticle

```

`claude mcp login` abre la pantalla de consentimiento de Relaticle en su navegador, donde usted elige el espacio de trabajo. También puede ejecutar `/mcp` dentro de una sesión. Claude Code guarda los tokens de OAuth por sí mismo, así que su configuración de MCP solo contiene la URL del servidor. Después, Claude Code muestra `relaticle` entre sus MCP servers, con las mismas herramientas que tienen Claude.ai y Desktop.

Un token de acceso personal sigue funcionando, por ejemplo un token de solo lectura para informes. Haga referencia a él mediante una variable de entorno para que el token no quede en la configuración:

```
claude mcp add relaticle \
  --transport http \
  https://mcp.relaticle.com \
  --header 'Authorization: Bearer ${RELATICLE_TOKEN}'

```

Un token escrito directamente en el encabezado se guarda en texto plano en `~/.claude.json`, o en `.mcp.json` dentro de su repositorio con `--scope project`. [Probamos dónde termina](https://relaticle.com/es/blog/permisos-de-claude-code-donde-termina-su-token-de-crm).

*Actualizado el 9 de noviembre de 2026: esta sección ahora empieza con OAuth. Antes mostraba el comando del token de acceso personal.*

| Cliente | Método de conexión | Tiempo de configuración típico |
|---|---|---|
| Claude.ai (web) | Conector personalizado con OAuth, Dynamic Client Registration | ~2 minutos |
| Claude Desktop | Conector personalizado con OAuth desde Customize → Connectors | ~2-5 minutos |
| Claude Code | `claude mcp add` más inicio de sesión con OAuth (`claude mcp login`) | ~2 minutos |
| ChatGPT | Conector personalizado con OAuth, Dynamic Client Registration | ~2 minutos |

[](#qué-puede-hacer-claude-las-herramientas "Permalink")Qué puede hacer Claude (las herramientas)
-------------------------------------------------------------------------------------------------

Cada conexión recibe 39 herramientas, comprobadas el 8 de noviembre de 2026. Hasta 11 herramientas de correo se suman cuando el token tiene acceso al correo, y se enumeran al final de esta sección. Una es de identidad (`who-ami-tool`), que devuelve el usuario autenticado, el espacio de trabajo actual, los miembros del espacio de trabajo y los permisos del token. Es una primera llamada útil para comprobar una conexión nueva. Dos son de descubrimiento entre entidades (`search` y `fetch`, descritas antes). Cinco funcionan a nivel del espacio de trabajo y no sobre un solo registro. `get-crm-schema-tool` y `list-custom-fields-tool` permiten descubrir campos. `get-crm-summary-tool` devuelve el recuento de registros y los totales del pipeline. `aggregate-opportunities-tool` devuelve los montos del pipeline agrupados por etapa o empresa. `list-activity-tool` permite saber quién cambió qué registro y qué cambió en cada campo. Las herramientas de carga sirven para guardar archivos. `upload-file` devuelve Markdown para campos de editor enriquecido, y `create-upload-url` prepara una carga firmada. Las 29 restantes cubren CRUD y relaciones para cinco entidades:

- **Empresas**: listar/buscar, obtener, crear (requiere `name`), actualizar, eliminar
- **Personas (contactos)**: listar/buscar, obtener, crear (requiere `name`, `company_id` opcional), actualizar, eliminar
- **Oportunidades (negocios)**: listar/buscar, obtener, crear (requiere `name`, `company_id`/`contact_id` opcionales), actualizar, eliminar
- **Tareas**: las cinco habituales, más `attach-task-to-entities-tool` y `detach-task-from-entities-tool` para vincular una tarea con empresas, personas y oportunidades, o para asignar y desasignar miembros del espacio de trabajo, sin borrar los vínculos existentes
- **Notas**: las cinco habituales, más vincular y desvincular con empresas, personas y oportunidades
- **Correo** (solo con acceso al correo): listar y leer correos y buzones conectados; crear, actualizar y eliminar borradores; enviar un borrador o un correo nuevo; cancelar, reprogramar o reintentar un envío en cola. Cada herramienta necesita el permiso correspondiente en el token (`email:read`, `email:draft` o `email:send`). Para enviar también hace falta un rol del espacio de trabajo que permita a los agentes enviar.

Las herramientas de listado aceptan `search`, `filter` (incluidos sus atributos personalizados, con operadores como `eq`, `gt`, `contains` e `in`), `sort`, `per_page` y `page`. Las herramientas de creación y actualización aceptan un objeto `custom_fields` para todo lo que vaya más allá de los campos integrados. Por ejemplo, las oportunidades de Relaticle incluyen de fábrica `stage`, `amount` y `close_date` como atributos personalizados. Es justo lo que necesita filtrar y ordenar una instrucción como "revisa mi pipeline".

Aquí entran en juego los cinco recursos de esquema. Antes de escribir en una entidad, Claude lee `relaticle://schema/company` (o `/people`, `/opportunity`, `/task`, `/note`) para conocer los códigos de campo y los valores de opción exactos que su equipo configuró. Si se equivoca, la escritura se rechaza por completo: los códigos de campo desconocidos no se descartan en silencio, sino que fallan en la validación. También hay un prompt integrado, **CRM Overview**, que devuelve el recuento de registros y las empresas y personas creadas recientemente. Es una buena forma de empezar una sesión antes de pedir algo más específico.

![Respuesta anterior de who-ami que muestra el contexto de la cuenta y los permisos del token](https://relaticle.com/storage/ink/01M09E1XESK0RRWGZ0034YFEFJ.png)

[](#escrituras-y-seguridad "Permalink")Escrituras y seguridad
-------------------------------------------------------------

Conviene tener clara esta parte antes de conectar nada con acceso de escritura.

Relaticle tiene dos lugares distintos desde los que una IA puede escribir en su CRM, y se comportan de forma diferente. Dentro de la aplicación, Rela, el asistente de IA integrado, solo propone escrituras: cuando le pide que cree o actualice un registro, arma una tarjeta de propuesta y espera a que usted haga clic en aprobar antes de guardar nada en la base de datos. Eso es una `PendingAction`, una fila real que permanece en estado pendiente hasta que una persona actúa.

MCP no funciona así. Cuando Claude llama a una herramienta de escritura del CRM, Relaticle valida la solicitud e invoca la acción correspondiente. Las escrituras exitosas se guardan directamente. No hay propuesta, ni tarjeta, ni un paso de aprobación aparte de por medio. La red de seguridad de las escrituras por MCP es la misma que esperaría de cualquier API que entregue a un agente: validación, comprobaciones de autorización según las políticas habituales de Relaticle y el alcance del token que le dio, no una aprobación humana integrada en el protocolo.

Esa diferencia importa para decidir cómo conectar a Claude. En la práctica, algunas cosas la atenúan:

- **La eliminación es lógica.** Todas las herramientas de eliminación hacen un soft delete: nada se pierde de forma permanente y los registros se pueden recuperar. Además, las herramientas de eliminación están marcadas como destructivas en sus metadatos de MCP, y un cliente que funcione bien puede usarlo para agregar su propia confirmación. Vale la pena revisar la configuración de su cliente si quiere ese aviso adicional.
- **Los registros creados por MCP llevan un origen.** Los registros creados por MCP reciben el origen de creación "Agente MCP". Actualizar un registro existente no reemplaza su origen de creación.
- **El alcance del token es donde realmente lo controla.** Los conectores OAuth (Claude.ai, el flujo de un clic de Claude Desktop, Claude Code, ChatGPT) reciben un único alcance que autoriza todo el conjunto de herramientas. El control más fino aquí es el espacio de trabajo al que puede llegar el conector, que se elige una sola vez en el consentimiento y queda fijo hasta que lo revoque. Los tokens de acceso personal permiten un control más detallado. Al crear uno, usted selecciona sus permisos (leer, crear, actualizar, eliminar, `email:read`, `email:draft` y `email:send`). Así, un token pensado para un informe de solo lectura puede crearse sin acceso de escritura, aparte de un token en el que confíe para CRUD completo.

Si quiere que Claude tenga acceso completo de lectura y escritura para ejecutar flujos de trabajo reales, para eso está diseñado. Si prefiere que solo mire y nunca toque nada, cree un token con alcance `read` únicamente y úselo. Las mismas herramientas funcionan, solo que se rechazan las de escritura.

[](#configuración-con-alojamiento-propio "Permalink")Configuración con alojamiento propio
-----------------------------------------------------------------------------------------

Nada de esto es exclusivo de la nube. Una instalación de Relaticle con alojamiento propio ejecuta el mismo MCP server, con las mismas herramientas, sin un paso de despliegue aparte ni una función que activar. Si no ha definido `MCP_DOMAIN`, el servidor está disponible en `{APP_URL}/mcp` desde la imagen de Docker. Defina esa variable si prefiere servirlo en su propio subdominio. Los tokens de acceso personal funcionan exactamente como se describió antes, y OAuth usa el mismo flujo basado en Passport contra su propio dominio una vez que lo configure.

Lo único que cambia en una instancia con alojamiento propio es la URL a la que apunta su cliente. Reemplace `https://mcp.relaticle.com` por su propio `{APP_URL}/mcp` en los fragmentos de configuración anteriores, o por su `MCP_DOMAIN` si definió uno. Todo lo demás, incluido el comportamiento de escritura directa descrito en la sección anterior, es idéntico al plan alojado de Relaticle. Para el recorrido completo del despliegue, consulte la [guía de alojamiento propio](https://relaticle.com/es/developers/self-hosting), o nuestro recorrido en el blog sobre [cómo alojar por su cuenta un CRM nativo de IA](https://relaticle.com/es/blog/autoalojar-un-crm-con-ia-en-2026), que cubre Docker, Coolify y Dokploy.

[](#flujos-de-trabajo-de-ejemplo "Permalink")Flujos de trabajo de ejemplo
-------------------------------------------------------------------------

Algunas cosas que vale la pena probar una vez conectado, todas construidas con herramientas que el servidor realmente tiene:

1. **Revisión del pipeline.** "Muéstrame todas las oportunidades en la etapa Negociación/Revisión, ordenadas por monto, y señala las que no tengan fecha de cierre." Use `list-opportunities-tool` con el filtro de etapa y el ordenamiento por monto. Siga la paginación hasta que `has_more` sea false y luego revise la fecha de cierre de cada resultado.
2. **Ingreso de datos después de una llamada.** "Acabo de hablar con Acme Corp. Crea la empresa, agrega a Jane Doe como contacto con el cargo de vicepresidenta de Ventas y registra una nota que resuma lo que hablamos." Son tres llamadas a herramientas. Primero, `create-company-tool`; luego, `create-people-tool` con `company_id` y el atributo personalizado `job_title`; por último, `create-note-tool` con `company_ids` y `people_ids` definidos directamente. La creación de notas acepta esos vínculos desde el principio, por lo que no hace falta una llamada de vinculación aparte.
3. **Destrabar un negocio estancado.** "Revisa las notas de la oportunidad de Acme y dime qué la está frenando. Luego actualiza la fecha de cierre si acordamos una en la llamada." Lee con `list-notes-tool`/`get-note-tool` y escribe con `update-opportunity-tool`.
4. **Resumen semanal.** "Dame un panorama del CRM y luego lista las empresas creadas esta semana y las tareas vencidas." Parte del prompt integrado CRM Overview y continúa con llamadas filtradas a `list-companies-tool` y `list-tasks-tool`.
5. **Tareas de seguimiento.** "Crea una tarea para dar seguimiento a John la próxima semana, asígnamela y vincúlala con la empresa y la oportunidad de Acme." Una llamada a `create-task-tool` y luego `attach-task-to-entities-tool` con `assignee_ids`, `company_ids` y `opportunity_ids` en la misma solicitud.
6. **Reasignar trabajo vencido.** "Busca las tareas con más de una semana de retraso y pásalas de Sarah a mí." Una llamada filtrada a `list-tasks-tool`, luego `detach-task-from-entities-tool` para quitar al asignado anterior y `attach-task-to-entities-tool` para agregar al nuevo.

![Una conversación con Claude que ejecuta una revisión del pipeline con list-opportunities-tool](https://relaticle.com/storage/ink/01M09FZ7TGV628QD22MTKZER4N.png)

Ninguno de estos casos requiere que explique primero su esquema. Claude lo lee de los recursos de esquema la primera vez que necesita un código de campo. Si algo no funciona como espera, o si quiere la referencia completa de herramientas, [relaticle.com/developers/mcp](https://relaticle.com/es/developers/mcp) tiene la lista completa. Las preguntas generales sobre la cuenta y el espacio de trabajo que no son específicas de MCP se resuelven en [relaticle.com/help](https://relaticle.com/es/help).

 Etiquetas [ #mcp ](https://relaticle.com/es/blog/tag/mcp) [ #claude ](https://relaticle.com/es/blog/tag/claude) 

 En esta página

 Siga leyendo

 Artículos relacionados. 
-------------------------

- [  17 de nov. de 2026  Guías 

    ###  Un agente de IA borró registros del CRM: ¿se pueden recuperar? 

    Si un agente de IA eliminó registros del CRM, la recuperación depende del CRM. Comparamos HubSpot, Salesforce, Attio y Relaticle, y probamos una restauración en Relaticle.

     ![](https://relaticle.com/storage/ink/01M7T5H20G1ED8KBPFX2T5P960.png) 

     ](https://relaticle.com/es/blog/un-agente-de-ia-borro-registros-del-crm-como-recuperarlos)
- [  13 de nov. de 2026  Guías 

    ###  Conectores de ChatGPT para su CRM: configuración segura 

    Los conectores de ChatGPT ahora son apps dentro de plugins. Conecte cada espacio de trabajo del CRM una sola vez. Compruebe qué permite su rol y sepa cómo revocar la conexión.

     ![](https://relaticle.com/storage/ink/01M7T5CSNHCJC6M6FXG3DPC2P3.png) 

     ](https://relaticle.com/es/blog/conectores-de-chatgpt-para-su-crm-configuracion-segura)
- [  9 de nov. de 2026  Guías 

    ###  Permisos de Claude Code: dónde termina su token de CRM 

    Los permisos de Claude Code pueden guardar un secreto en texto plano. Probamos dónde queda un token de CRM y por qué OAuth lo mantiene fuera de sus archivos de configuración.

     ![](https://relaticle.com/storage/ink/01M7T1DM6SMBNVQ7BME95WJ8E8.png) 

     ](https://relaticle.com/es/blog/permisos-de-claude-code-donde-termina-su-token-de-crm)
