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 artificialiccomo “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 Configuración → Conectores.
Haz clic en “Agregar conector personalizado” (Add custom connector).
Ponle un nombre (ej. Artificialic) y pega la URL https://TU-DOMINIO/api/mcp.
Guarda y haz clic en Conectar. Se abrirá la pantalla de autorización en tu navegador; inicia sesión, elige organización y permisos, y aprueba.

Los conectores personalizados requieren un plan de pago de Claude (Pro/Max/Team/Enterprise).

Conectar desde Claude web (claude.ai)

En claude.ai, ve a Configuración → Conectores.
“Agregar conector personalizado” → pega https://TU-DOMINIO/api/mcp.
Autoriza el acceso en la pantalla de consentimiento.

En cuentas de equipo/empresa, los conectores personalizados los habilita un administrador desde la configuración de la organización. Requiere un plan de pago. La URL debe ser pública (ver la nota de arriba).

Conectar desde ChatGPT

ChatGPT soporta servidores MCP mediante conectores (en planes Plus/Pro/Business/Enterprise, dentro del modo desarrollador/ avanzado):

Ve a Configuración → Conectores y activa el modo avanzado/desarrollador si aplica.
Crear/agregar conector → tipo MCP Server.
Pega la URL https://TU-DOMINIO/api/mcp y déjalo autenticar por OAuth (elige el método de autenticación OAuth, no API key).
Aprueba el acceso en la pantalla de consentimiento.

El soporte de MCP en ChatGPT está en evolución y, según el modo, puede exponer solo algunas de las tools. Para el conjunto completo de acciones, Claude (Code/Desktop/web) es hoy el cliente más completo.

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.