Servidor MCP

El servidor MCP (Model Context Protocol) te deja conectar asistentes de IA —como Claude o ChatGPT— directamente a tu cuenta de Artificialic. Una vez conectado, la IA puede leer tus conversaciones, gestionar contactos y etiquetas, crear automatizaciones, lanzar difusiones y mucho más, siempre con los permisos que tú apruebes.

Requiere un plan con acceso a MCP. Si tu plan no lo incluye, verás un aviso al intentar conectarte. Consulta los planes o contacta a soporte para habilitarlo.

No necesitas una API key. A diferencia de la API REST, el servidor MCP usa OAuth: el cliente de IA te abre una pantalla donde inicias sesión y eliges qué permisos otorgar. Puedes revocar el acceso cuando quieras desde Ajustes.

¿Qué es MCP?

MCP es un estándar abierto que permite a los asistentes de IA conectarse a herramientas y datos externos de forma segura. Cuando conectas Artificialic como servidor MCP, tu asistente gana un conjunto de tools (acciones) para operar tu cuenta: buscar conversaciones, enviar mensajes, crear etiquetas, armar automatizaciones, etc.

Todo pasa en nombre de una organización específica (la que elijas al conectar) y respeta tus permisos: la IA nunca puede hacer algo que tú no podrías hacer desde el panel, ni tocar configuraciones sensibles (facturación, datos de la organización, roles de usuarios).

La URL de conexión

Todos los clientes usan la misma URL. La encuentras también en Ajustes → Servidor MCP dentro del panel:

https://TU-DOMINIO/api/mcp

Importante: reemplaza TU-DOMINIO por la dirección pública de tu instancia (la misma que usas para entrar al panel). Los clientes en la nube —Claude web y ChatGPT— necesitan que esa URL sea accesible desde internet. Una dirección de desarrollo local (que solo resuelve en tu máquina) funciona con Claude Code y Claude Desktop en esa misma máquina, pero no desde la nube.

Conectar desde Claude Code

Claude Code es el cliente de línea de comandos. Agrega el servidor con:

claude mcp add --transport http artificialic https://TU-DOMINIO/api/mcp

Luego, dentro de una sesión de Claude Code, escribe /mcp. Verás artificialic como “needs authentication”; selecciónalo y se abrirá tu navegador en la pantalla de autorización. Inicia sesión, elige la organización y los permisos, y aprueba. Al terminar, las tools quedan disponibles.

Los servidores MCP se cargan al iniciar Claude Code. Si tras agregarlo no aparece en /mcp, reinicia Claude Code y vuelve a intentarlo.

Conectar desde Claude Desktop

Abre Personalizar → Conectores (Customize → Connectors).
Usa Agregar → Personalizado → Web para crear una conexión remota.
Escribe un nombre y pega https://TU-DOMINIO/api/mcp.
Elige iniciar sesión con OAuth. Si se solicita el método de registro del cliente, selecciona el registro automático (Register automatically).
Completa la conexión, inicia sesión en artificialic, elige organización y permisos y aprueba el acceso.

La disponibilidad y las restricciones dependen de tu cuenta y de las políticas del espacio de trabajo. Consulta la guía oficial de conectores de Claude si los nombres de las opciones cambian.

Conectar desde Claude web (claude.ai)

En claude.ai, abre Personalizar → Conectores y sigue los pasos de conexión remota indicados arriba. El conector se administra desde tu cuenta de Claude y puede usarse también en sus otras superficies compatibles. En organizaciones de equipo, quien administra el espacio puede necesitar habilitarlo.

La conexión remota se realiza desde la infraestructura de Anthropic: la URL de artificialic debe ser accesible desde allí. Una dirección local que solo abre en tu computadora no sirve para ese recorrido.

Conectar desde ChatGPT

En ChatGPT web, el servidor MCP se agrega como un plugin con herramientas de lectura y escritura. Los permisos y las restricciones del espacio de trabajo pueden limitar su uso.

Abre la sección Plugins de ChatGPT y usa el botón de agregar para elegir Add custom MCP server.
Escribe un nombre y, en la conexión, pega https://TU-DOMINIO/api/mcp como URL del servidor.
Configura OAuth. Si se solicita el método de registro, usa el registro dinámico de clientes (DCR) que ofrece artificialic.
Completa la creación e instala el plugin en el espacio donde lo vas a utilizar.
Conecta tu cuenta cuando se solicite: inicia sesión en artificialic, elige organización y permisos y aprueba el acceso.

Sigue la documentación oficial de OpenAI para agregar un servidor MCP si la interfaz o los requisitos de tu espacio cambian. Las herramientas disponibles también dependen de los permisos que autorizaste en artificialic.

Otros clientes MCP

Cualquier cliente compatible con MCP sobre HTTP (Streamable HTTP) y OAuth 2.1 puede conectarse. Solo necesita la URL https://TU-DOMINIO/api/mcp. El cliente descubre automáticamente los endpoints de autorización (registro dinámico de cliente + OAuth), así que no hace falta configurar client IDs ni secrets a mano.

Permisos (scopes)

Al conectar, la pantalla de consentimiento te muestra los permisos que el cliente solicita. Puedes desmarcar los que no quieras otorgar. Están agrupados por módulo, en lectura (:read) y escritura (:write):

Conversaciones y mensajes — buscar, leer, enviar, asignar, archivar. Incluye un permiso aparte para ver todas las conversaciones de la organización.
Contactos — buscar, crear, editar, fusionar, eliminar.
Etiquetas y carpetas — organizar conversaciones.
Automatizaciones y agentes IA — crear y editar flujos y bots.
Difusiones — crear, lanzar, pausar, cancelar.
Plantillas, canales, catálogo, agenda, bases de datos y equipos — según el permiso otorgado.

Lo que MCP nunca puede tocar: facturación, datos y configuración de la organización, cuentas y contraseñas de usuarios, edición de roles/permisos del equipo, y la gestión de las propias credenciales. Esas operaciones son solo del panel.

Gestionar y revocar el acceso

En Ajustes → Servidor MCP ves la lista de clientes que autorizaste, con los permisos de cada uno y su último uso. El botón Revocar corta el acceso de ese cliente al instante: su siguiente intento fallará y tendrá que volver a autorizarse.

Solución de problemas

“Tu plan no incluye el servidor MCP” — tu plan no tiene la función habilitada. Cámbialo o contacta a soporte.
El cliente en la nube no conecta — Claude web y ChatGPT necesitan que la URL sea pública. Una dirección de desarrollo local no es alcanzable desde internet.
La conexión funcionaba y de golpe da error 401 — el acceso pudo haberse revocado desde Ajustes, o tu plan dejó de incluirlo. Vuelve a conectar el cliente.
No aparecen todas las tools — solo se muestran las que cubren los permisos que otorgaste. Reconéctate y aprueba más scopes si necesitas más acciones.