Conectar una app de IA (MCP)

Zabio tiene un servidor MCP (Model Context Protocol, el estándar que usan las apps de IA para llamar a herramientas externas). Conecta una app como Claude y podrá consultar la documentación, los modelos y los precios de Zabio, leer el uso y las llamadas recientes de tu proyecto y enviar tareas a los modelos de Zabio, todo desde un chat.

Dos direcciones

Dirección	Inicio de sesión	Qué ofrece
`https://mcp.zabio.ai/public`	ninguno	La documentación, los modelos, los precios, los hosts y el estado de Zabio. Nada sobre tu cuenta.
`https://mcp.zabio.ai/mcp`	tu cuenta de Zabio, una vez, al conectar la app	las mismas herramientas, más el uso y las llamadas de tu proyecto, y preguntar a los modelos de Zabio

Usa /public para conocer Zabio antes de registrarte, o en una app a la que no quieras dar acceso a tu cuenta. Usa /mcp para todo lo demás.

Configurar Claude.ai y las apps de Claude

Los conectores personalizados funcionan en todos los planes de Claude (el plan gratuito permite uno).

En Claude, abre Customize y después Connectors.
Haz clic en + Add y después en Add custom connector.
Llámalo Zabio y escribe https://mcp.zabio.ai/mcp como URL. Haz clic en Continue.
Deja los ajustes de autenticación que detecta Claude y haz clic en Add.
Claude abre la página de conexión de Zabio. Inicia sesión en Zabio si no la tienes iniciada, elige tus opciones (consulta Qué eliges al conectar) y haz clic en Permitir.

Para usarlo en un chat, haz clic en + abajo a la izquierda del chat, después en Connectors, y activa Zabio.

Si la página de Zabio no ofreció Hacer preguntas a los modelos de Zabio cuando conectaste Claude, la primera vez que se le pida a Zabio una tarea Claude muestra una tarjeta para aprobarlo: consulta Permitir ask más tarde.

En un plan Team o Enterprise, un propietario añade el conector en Organization settings, Connectors: Add, Custom, Web, con la misma URL. Después cada miembro hace clic en Connect en Customize, Connectors, y elige sus propias opciones en la página de Zabio. La conexión de cada miembro es solo suya.

El conector que añades en Claude.ai funciona también en Claude Desktop y en las apps móviles de Claude.

Configurar Claude Code

En una terminal:

claude mcp add --transport http --scope user zabio https://mcp.zabio.ai/mcp

Después, en Claude Code, ejecuta /mcp, elige zabio y sigue los pasos en tu navegador: inicia sesión en Zabio si no la tienes iniciada, elige tus opciones y haz clic en Permitir. También puedes iniciar sesión desde la terminal con claude mcp login zabio.

Si falta ask, Claude Code dice que la llamada necesita permisos adicionales: ejecuta /mcp, elige zabio, vuelve a conectarlo y marca Hacer preguntas a los modelos de Zabio (consulta Permitir ask más tarde). Un conector de Zabio añadido en Claude.ai también aparece en Claude Code como claude.ai Zabio; es una conexión aparte, con sus propias opciones.

--scope user deja Zabio disponible en todos los proyectos de tu ordenador. Quítalo para añadirlo solo al proyecto actual.

Sin cuenta de Zabio, añade en su lugar las herramientas públicas:

claude mcp add --transport http --scope user zabio-public https://mcp.zabio.ai/public

Configurar Codex

Codex CLI y la app de Codex se configuran igual. En una terminal:

codex mcp add zabio --url https://mcp.zabio.ai/mcp
codex mcp login zabio

El inicio de sesión abre la página de conexión de Zabio en tu navegador: inicia sesión en Zabio si no la tienes iniciada, elige tus opciones y haz clic en Permitir. Inicia sesión una sola vez y después abre una sesión nueva de Codex para que use la conexión.

Configurar Cursor

Añade Zabio a ~/.cursor/mcp.json (o a .cursor/mcp.json en un proyecto):

{
  "mcpServers": {
    "zabio": { "url": "https://mcp.zabio.ai/mcp" }
  }
}

En Cursor Settings, MCP, Zabio indica que necesita iniciar sesión: haz clic, elige tus opciones en la página de Zabio y haz clic en Permitir.

Configurar VS Code

Añade Zabio a .vscode/mcp.json en tu espacio de trabajo (o ejecuta MCP: Add Server desde la paleta de comandos y elige HTTP):

{
  "servers": {
    "zabio": { "type": "http", "url": "https://mcp.zabio.ai/mcp" }
  }
}

Inicia el servidor desde el archivo o con el comando MCP: List Servers. VS Code te pide iniciar sesión: acéptalo, elige tus opciones en la página de Zabio y haz clic en Permitir.

Configurar OpenCode

Añade Zabio a opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "zabio": { "type": "remote", "url": "https://mcp.zabio.ai/mcp" }
  }
}

Después ejecuta opencode mcp auth zabio, elige tus opciones en la página de Zabio y haz clic en Permitir. Si la página de Zabio no ofreció Hacer preguntas a los modelos de Zabio cuando conectaste, vuelve a ejecutar opencode mcp auth zabio para permitirlo (consulta Permitir ask más tarde).

Otras apps

Cualquier app MCP que se conecte a servidores remotos por streamable HTTP e inicie sesión con OAuth puede conectarse a https://mcp.zabio.ai/mcp: añade la URL como servidor remoto y la app abrirá la página de conexión de Zabio. Zabio acepta apps que se identifican con un documento de metadatos de cliente y apps que se registran solas, así que la app no necesita que le des un client id ni un secreto. https://mcp.zabio.ai/public no necesita iniciar sesión.

Zabio también figura en el registro oficial de MCP como ai.zabio/zabio, así que una app que consulte el registro puede encontrarlo por su nombre.

Esta página solo da pasos para las apps que hemos conectado nosotros mismos. Añadiremos más a medida que las probemos.

Qué eliges al conectar

La página de conexión de Zabio (en app.zabio.ai) muestra el nombre de la app, cómo se identificó y a dónde vuelve. Cuando vuelve a un programa de tu propio ordenador, como hace Claude Code, la página lo avisa: conéctala solo si acabas de iniciar tú la conexión. Antes tienes que haber confirmado tu dirección de email.

Organización y Proyecto. Cualquier miembro de una organización puede conectar una app, en los proyectos que puede usar. La app solo ve el uso y las llamadas de ese proyecto, nunca los de otro.
Qué puede hacer la app. Siempre puede leer: el uso, el gasto y las llamadas recientes de este proyecto, y los modelos, precios y documentación de Zabio. Marca Hacer preguntas a los modelos de Zabio para que pueda usar la herramienta ask, que gasta el crédito de tu organización.
Límite de gasto diario (USD). Lo máximo que la app puede gastar en un día, que se reinicia a las 00:00 UTC. La página muestra el valor por defecto de hoy y el máximo que puedes elegir.
La conexión caduca en 7, 30, 90 o 365 días. Después hay que volver a conectar la app.

Haz clic en Permitir para conectar o en Rechazar para negarte; la app recibe la respuesta en ambos casos.

Volver a conectar una app. Cuando una app que inicia sesión a través de una dirección web (Claude.ai, VS Code, Cursor) se aprueba de nuevo para la misma organización y el mismo proyecto, la conexión nueva sustituye a la anterior: la página lo indica antes de Permitir, y la conexión anterior y su key dejan de funcionar al hacer clic. Las apps de tu propio ordenador (Claude Code, Codex, OpenCode) conservan cada conexión, porque puedes usarlas en más de un ordenador.

Permitir ask más tarde

Una conexión hecha solo con lectura sigue mostrando la herramienta ask cuando su app nunca pidió ask. Al usarla, Zabio pide el permiso a la app y la app te lo pide a ti: Claude muestra una tarjeta en el chat y VS Code te pide iniciar sesión de nuevo. En Claude Code ejecuta /mcp y vuelve a conectar zabio; en OpenCode ejecuta opencode mcp auth zabio. En la página de Zabio, marca Hacer preguntas a los modelos de Zabio y haz clic en Permitir. Hasta el 2026-10-14, el inicio de sesión de Zabio solo nombraba la lectura, así que Claude, OpenCode, VS Code y Cursor nunca ofrecían ask; si la página no lo ofreció cuando conectaste, así es como tu conexión lo obtiene.

Si la app pidió ask y lo dejaste sin marcar, la conexión no muestra ask. Para cambiarlo, desconéctala en Apps conectadas y vuelve a conectar la app.

Una API key por conexión. Permitir crea una API key para la conexión, con el nombre MCP: seguido del de la app (por ejemplo MCP: Claude Code), en el proyecto que elegiste, con tu límite diario como límite de gasto diario y la caducidad de la conexión. Aparece en Claves API y en el Registro como cualquier key, su secreto nunca se muestra, y se le aplica el acceso a modelos que fijaste en la cuenta, la organización y el proyecto (consulta Acceso a modelos). Estas keys no cuentan para las dos keys del plan Free. Una organización solo puede tener unas pocas apps conectadas a la vez (la página indica cuántas); cuando está llena, la página las lista para que desconectes una primero.

Las herramientas

En las dos direcciones:

Herramienta	Qué hace
`search_docs`	Busca en la documentación de Zabio, en inglés o en español, y devuelve las secciones que mejor encajan con sus enlaces
`read_doc`	Lee una página de la documentación, entera o una sección
`models`	Lista los modelos que sirve Zabio: proveedor, nivel, si `auto` puede elegirlo hoy, capacidades y precios por millón de tokens (precios fuera de hora punta y por lotes cuando el modelo los tiene)
`model_hosts`	Muestra cada host que sirve un modelo a través de Zabio, dónde procesa las peticiones, su precio y sus horas fuera de hora punta
`status`	El estado del servicio de Zabio, como lo muestra zabio.ai/status
`ping`	Comprueba que el servidor responde

Los precios que devuelven models y model_hosts son los que cobra Zabio: el precio del proveedor con la comisión de servicio de Zabio, (consulta la página de precios), incluida. En /mcp siguen el plan de tu organización y muestran solo los modelos que tu conexión puede usar.

Solo en /mcp:

Herramienta	Qué hace
`usage`	El uso del proyecto en un periodo (hoy, 7 días, 30 días, este mes o las fechas que indiques): llamadas, errores, lo facturado, el coste de los proveedores, las comisiones de Zabio, lo que ahorró el enrutado, tokens y el saldo de la organización. Agrupado por modelo, día o key si lo pides
`recent_calls`	Las últimas llamadas del proyecto, de la más reciente a la más antigua: hora, key, el modelo pedido y el que respondió, tokens, coste, ahorro (ninguno en una llamada hecha mientras la referencia de la key estaba pendiente, marcada con `baseline_pending`), latencia y resultado. Nunca el texto de una petición ni de una respuesta
`get_call`	Una llamada por su id (`call_...`, como lo muestran el Registro y el `zabio.call_id` de cada respuesta, o la forma `chatcmpl-...`): sus detalles, cómo se reparte su coste entre el precio del proveedor y las comisiones de Zabio, el ahorro (como lo indica `recent_calls`), por qué el enrutado eligió su modelo y, cuando Zabio dividió una petición grande, cómo lo hizo y lo que ahorró la división (División y enrutado)
`feedback`	Le dice a Zabio que una respuesta fue mala o buena, por el id de la llamada, con un motivo opcional (hasta 500 caracteres). Una respuesta mala hace que Zabio vuelva a elegir el modelo de esa sesión en su siguiente turno. No gasta crédito
`ask`	Envía una tarea a un modelo a través de Zabio y devuelve la respuesta. Solo si permitiste hacer preguntas

Ninguna herramienta crea ni cambia keys, ajustes, pagos ni planes.

Preguntar a los modelos de Zabio

ask funciona con la key de la conexión, por el mismo camino que una llamada a la API: se aplican el acceso a modelos, el límite diario, las comisiones y el Registro. Por defecto usa auto, que elige el modelo más barato capaz de hacer el trabajo; la app puede indicar una línea (auto/cheap, auto/balanced, auto/best) o un modelo. Se factura como cualquier otra llamada con ese modelo (consulta Facturación).

La app también puede fijar el tope de longitud de la respuesta (max_output_tokens), el esfuerzo de razonamiento (low, medium, high) y un session_id para que las preguntas relacionadas compartan la caché de prompts y el enrutado. Una tarea muy larga se rechaza indicando su tamaño y el límite; envíala a la API.

Cada respuesta termina con una línea, en inglés:

Answered by gpt-6-luna. Cost 0.000292 USD, saved 0.0011 USD against claude-sonnet-5-5.

La respuesta indica también, en split, cuándo Zabio respondió una tarea grande a partir de un extracto, como hace zabio.split en la API.

El ahorro se cuenta frente al modelo de referencia de la key, como en cualquier llamada. La key de una conexión nueva no tiene modelo de referencia hasta que hace 20 llamadas, así que la línea dice cuántas llamadas faltan en lugar de un ahorro (consulta Cuánto cuesta una llamada). Cuando vuelves a conectar la misma app al mismo proyecto, la key nueva continúa la anterior: conserva su modelo de referencia, o las llamadas que ya llevaba hacia él.

ask espera la respuesta hasta un minuto y medio, más o menos, cuando la app no muestra el progreso; las apps que muestran el progreso pueden esperar más. Si una llamada se queda sin tiempo, le pide a la app una respuesta más corta.

Gestionar las conexiones

Ajustes, Apps conectadas lista cada app que conectaste: su organización y proyecto, qué puede hacer, su límite diario, cuándo se conectó y se usó por última vez, y cuándo caduca. Desconectar termina la conexión al momento y revoca su key. Revocar la key en Claves API también desconecta la app.

Una conexión también termina cuando caduca, cuando sales de la organización o pierdes el acceso al proyecto (en menos de una hora), y cuando se cierra la organización o tu cuenta. Cerrar sesión en la app web no termina las conexiones.

Las peticiones a /mcp tienen un límite por conexión, y las de /public por dirección; una app que envía demasiadas recibe rate_limit_exceeded y puede volver a intentarlo un minuto después.