Conectar agentes de IA (MCP)
La API pública también es un servidor MCP remoto, así que cualquier cliente de agente compatible puede usarla como un conjunto de herramientas. Cada operación REST se convierte en una herramienta, derivada del mismo documento OpenAPI que publica este sitio.
Opción 1: iniciar sesión con OAuth
Pega la URL del endpoint en el cliente: descubrirá el servidor de autorización y abrirá una pantalla de consentimiento en tu navegador. Los clientes con una identidad estable mediante documento de metadatos la usan directamente; los demás clientes compatibles se registran dinámicamente como alternativa. Apruebas los permisos una vez y puedes revocar la concesión en Ajustes → API y MCP. OAuth es la única opción para asistentes alojados sin campo para un token bearer.
Opción 2: enviar una clave de API
Crea una clave en los ajustes de tu cuenta, concédele solo los permisos que el agente necesita y haz que el cliente la envíe como cabecera Authorization bearer. El secreto se muestra una sola vez al crearlo. Los clientes de línea de comandos y de editor lo admiten; no requiere pasar por el navegador, lo que resulta cómodo para scripts y CI.
Configuración por cliente
Endpoint MCP
https://nextjs-saas-template.lubomirgeorgiev.com/mcpStreamable HTTP. La mayoría de clientes solo necesitan esta URL.
El cliente abre una ventana del navegador y apruebas los permisos solicitados una sola vez. No hay nada que copiar, y puedes revocarlo después en la lista de apps conectadas de Ajustes → API y MCP.
Ejecuta este comando.
claude mcp add --transport http saas-template https://nextjs-saas-template.lubomirgeorgiev.com/mcp
# then run /mcp inside Claude Code and authenticate in the browserPega esta URL en los ajustes de conectores del cliente.
https://nextjs-saas-template.lubomirgeorgiev.com/mcpPega esta URL en los ajustes de conectores del cliente.
https://nextjs-saas-template.lubomirgeorgiev.com/mcpEjecuta este comando.
codex mcp add saas-template --url https://nextjs-saas-template.lubomirgeorgiev.com/mcp
codex mcp login saas-templateAñade esto a ~/.cursor/mcp.json.
{
"mcpServers": {
"saas-template": {
"url": "https://nextjs-saas-template.lubomirgeorgiev.com/mcp"
}
}
}Añade esto a .vscode/mcp.json.
{
"servers": {
"saas-template": {
"type": "http",
"url": "https://nextjs-saas-template.lubomirgeorgiev.com/mcp"
}
}
}Añade esto a ~/.gemini/config/mcp_config.json.
{
"mcpServers": {
"saas-template": {
"serverUrl": "https://nextjs-saas-template.lubomirgeorgiev.com/mcp"
}
}
}Ejecuta este comando.
grok mcp add --transport http saas-template https://nextjs-saas-template.lubomirgeorgiev.com/mcp
# OAuth runs on first use; approve in the browser, or press i on the server in /mcpsAñade esto a ~/.config/opencode/opencode.json.
{
"mcp": {
"saas-template": {
"type": "remote",
"url": "https://nextjs-saas-template.lubomirgeorgiev.com/mcp",
"enabled": true
}
}
}Qué herramientas ve un agente
El listado de herramientas se filtra según la credencial: una operación cuyo permiso no tenga la clave o la concesión nunca se anuncia, así que el agente ni siquiera puede intentarla. Los permisos de equipo se comprueban de nuevo en cada llamada, de modo que revocar la pertenencia de alguien también elimina el acceso de su agente. Las llamadas fallidas devuelven el código de error estable de la API en lugar de texto traducido, que es lo que permite a un modelo reaccionar ante un permiso ausente o un límite de velocidad.