Claude Code, Codex y otros clientes MCP

Las herramientas de desarrollo y los demás clientes MCP se conectan a Callbell con la misma URL de servidor y el mismo inicio de sesión de Callbell que Claude y ChatGPT. Cada persona que usa la conexión inicia sesión con su propio usuario de Callbell.

Claude Code

tip

Si usas Claude Code con tu cuenta de claude.ai y ya añadiste Callbell en Claude (consulta Conectar Claude), Callbell ya está disponible en Claude Code.

1. Añade el servidor:

claude mcp add --transport http callbell https://ai.callbell.eu/mcp

Por defecto, el servidor solo está disponible en el proyecto actual. Añade --scope user para usarlo en todos tus proyectos, o --scope project para compartirlo con tu equipo en un archivo .mcp.json (cada compañero sigue iniciando sesión con su propio usuario de Callbell).

2. Inicia Claude Code, ejecuta /mcp, selecciona callbell y elige Authenticate. También puedes ejecutar claude mcp login callbell desde tu terminal.
3. Tu navegador abre la página de consentimiento de Callbell. Elige los permisos y haz clic en Permitir.

Claude Code guarda la conexión y la renueva automáticamente.

Codex

1. Añade el servidor:

codex mcp add callbell --url https://ai.callbell.eu/mcp

2. Codex detecta que Callbell usa OAuth y abre tu navegador. Si no lo hace, ejecuta:

codex mcp login callbell

3. En la página de consentimiento de Callbell, elige los permisos y haz clic en Permitir.

También puedes añadir el servidor a mano en ~/.codex/config.toml y después ejecutar codex mcp login callbell:

[mcp_servers.callbell]
url = "https://ai.callbell.eu/mcp"

La CLI de Codex, la extensión de Codex para IDE y la aplicación de escritorio de ChatGPT comparten esta configuración.

Otros clientes MCP

Cualquier cliente MCP compatible con servidores remotos por Streamable HTTP e inicio de sesión OAuth puede conectarse a Callbell. La mayoría de los clientes solo necesitan la URL, por ejemplo en una configuración JSON:

{
  "mcpServers": {
    "callbell": {
      "type": "http",
      "url": "https://ai.callbell.eu/mcp"
    }
  }
}

El cliente encuentra solo los ajustes de inicio de sesión. Como referencia, estos son los detalles técnicos:

Ajuste	Valor
Servidor MCP	https://ai.callbell.eu/mcp (Streamable HTTP)
Metadatos del recurso protegido	https://ai.callbell.eu/.well-known/oauth-protected-resource
Servidor de autorización	https://dash.callbell.eu
Metadatos del servidor de autorización	https://dash.callbell.eu/.well-known/oauth-authorization-server
Registro del cliente	Registro dinámico en https://dash.callbell.eu/oauth/register
Tipo de concesión	Código de autorización con PKCE (S256), con tokens de actualización
Scopes	read, write
URI de redirección	Cualquier URL https, o http en localhost o una dirección de loopback para clientes de escritorio y de línea de comandos

note

El servidor MCP solo acepta los tokens OAuth emitidos por el inicio de sesión de Callbell. Las claves API de Callbell no funcionan con él: para llamar a Callbell desde tu propio código, usa la API de Callbell.

Herramientas disponibles

Estas son las acciones que el asistente puede realizar en Callbell:

Herramienta	Permiso	Qué hace
find_contacts	Lectura	Busca un contacto por número de teléfono, o lista contactos filtrados por canal, etiquetas o equipo. No hay búsqueda por nombre.
get_contact	Lectura	Obtiene un contacto con sus etiquetas, campos personalizados, equipo, canal y estado de la conversación.
list_messages	Lectura	Lee los mensajes de la conversación de un contacto, del más reciente al más antiguo, incluidas las notas internas.
list_channels	Lectura	Lista los canales conectados (WhatsApp, Instagram, Facebook Messenger y Telegram).
list_teams	Lectura	Lista los equipos de la cuenta.
list_templates	Lectura	Lista las plantillas de WhatsApp y su estado de aprobación.
send_message	Escritura	Envía un mensaje de WhatsApp a un contacto existente. Fuera de la ventana de atención al cliente de 24 horas, solo se pueden enviar plantillas aprobadas.
update_contact	Escritura	Cambia el nombre de un contacto, añade o quita etiquetas, rellena campos personalizados o mueve la conversación a otro equipo.
add_note	Escritura	Añade una nota interna a una conversación. Las notas solo las ve tu equipo, nunca el contacto.
close_conversation	Escritura	Cierra la conversación de un contacto.

note

El asistente solo puede escribir a contactos que ya existen en Callbell: no puede iniciar una conversación con un número nuevo. Las plantillas de autenticación (códigos de un solo uso) no se pueden enviar desde una aplicación de IA.