Servidor MCP
El servidor MCP de Nimobase conecta tu agente de IA —Claude Code, Cursor, Codex, opencode, Cline— con tu empresa. Le pides cosas en lenguaje natural —quién usa tu cuenta, qué facturas hay este mes, manda una notificación al equipo— y el agente las hace por ti, con tus permisos. MCP (Model Context Protocol) es simplemente el estándar que permite a un agente de IA usar herramientas externas como esta.
Antes de empezar
- Un cliente con soporte MCP: Claude Code, Cursor, Codex, opencode o Cline. Cualquiera sirve.
- Una cuenta de Nimobase con una empresa activa (o una clave de API de esa empresa, si prefieres la conexión local).
- Tus mismos permisos, ni uno más: el servidor no tiene privilegios propios. Lo que tu cuenta o tu clave no pueden hacer, el agente tampoco.
Conectarte
Remoto (lo recomendado)
No instalas nada: registras el endpoint en tu cliente y te autenticas una vez.
| Entorno | URL |
|---|---|
| Producción | https://mcp.nimobase.com/mcp |
| Sandbox | https://mcp-sta.nimobase.com/mcp |
Regístralo bajo la clave nimobase —no mcp, no nimobase-mcp—. Otros servidores MCP de tu máquina suelen usar esos nombres genéricos, y un nombre repetido hace que el cliente eclipse una entrada en silencio.
La primera vez que lo uses pasará esto:
- Tu cliente abre el navegador.
- Inicias sesión en Nimobase y eliges la empresa.
- Ves, en lenguaje humano, qué acciones se piden, y las apruebas.
- Tu cliente guarda el acceso: no repites el proceso hasta que expire.
Si tu cliente no puede abrir un navegador, puedes pasarle el token directamente en la cabecera Authorization: Bearer ….
Claude Code
claude mcp add --transport http nimobase https://mcp.nimobase.com/mcpDespués, dentro de Claude Code: /mcp → nimobase → Authenticate, y sigue el flujo del navegador. En una máquina sin interfaz gráfica, claude mcp login nimobase hace lo mismo desde la shell.
Local (stdio)
Si prefieres un proceso en tu máquina, añade esto a la configuración MCP de tu cliente:
{
"mcpServers": {
"nimobase": {
"command": "node",
"args": [
"/absolute/path/to/packages/mcp-server/dist/bin/nimobase-mcp.js"
],
"env": {
"NIMOBASE_API_KEY": "sk_…"
}
}
}
}| Variable | Requerida | Para qué |
|---|---|---|
NIMOBASE_API_KEY | sí | Tu clave sk_… o pk_…. Define qué puede ver y hacer el agente — lo mismo que con el SDK |
| (ninguna) | no | Sin ninguna variable, el servidor apunta a Producción |
NIMOBASE_SANDBOX | no | Ponla en true para trabajar contra Sandbox |
NIMOBASE_BASE_URL | no | Escape hatch: si la defines, gana sobre lo anterior y apunta a la API que indiques |
Para trabajar contra Sandbox, añade esa variable a env; sin ella, vas a Producción:
{
"mcpServers": {
"nimobase": {
"command": "node",
"args": [
"/absolute/path/to/packages/mcp-server/dist/bin/nimobase-mcp.js"
],
"env": {
"NIMOBASE_API_KEY": "sk_…",
"NIMOBASE_SANDBOX": "true"
}
}
}
}Si la clave falta, está mal, expiró o fue revocada, el proceso no arranca y dice por qué. Así el agente nunca ve una lista de tools a medias.
Esto configura el proceso local: el agente habla con la API de Sandbox. Si usas el transporte remoto, el entorno no se elige con esta variable sino con la URL del endpoint, en la tabla de más arriba: son dos caminos distintos, no dos formas de lo mismo.
Cómo usarlo
Una vez conectado, solo pide. El agente decide qué herramienta usar, la ejecuta con tus permisos y te cuenta el resultado. Por ejemplo:
- "Lista los usuarios de mi empresa" →
users_list - "Invita a ana@ejemplo.com como MEMBER" →
invitations_create - "¿Qué facturas tengo este mes?" →
billing_list_invoices - "Manda una notificación al equipo sobre la ventana de mantenimiento" →
notifications_send - "Comprueba que la conexión funciona" →
whoami - "Genera un cliente SDK de TypeScript en este proyecto" →
scaffold_integration
Qué puede hacer
Las tools cubren las funcionalidades del producto. Los nombres siguen el patrón <módulo>_<acción>, así que el agente los deduce sin leer un catálogo:
| Funcionalidad | Qué resuelve |
|---|---|
| Users | Las personas de tu empresa: listar, ver, dar de alta, actualizar |
| Companies | Tu empresa: sus datos, sus miembros, añadir gente |
| Notifications | Enviar, programar y seguir notificaciones; gestionar dispositivos |
| Billing | Suscripción, facturas, entitlements, checkout y portal de pago |
| Invitations | Invitar personas y gestionar invitaciones pendientes |
Algunas cosas que conviene saber:
- Nada destructivo se ejecuta sin confirmación. Borrar, cancelar una suscripción o revocar una invitación requiere
confirm: trueen la llamada; sin eso, la acción se rechaza antes de tocar nada. whoamiconfirma que la conexión está viva y con qué tipo de clave.scaffold_integrationdeja un cliente SDK funcionando (TypeScript, Python o navegador) en tu proyecto. Escribe archivos y no llama a la API; si ya hay una integración, la respeta.- El servidor también trae guías de integración que el agente puede leer por su cuenta, para que escriba código correcto sin que tú pegues contexto en el chat.
Errores
Si algo falla, el agente lo ve tal cual: validación, permisos, recurso no encontrado o límite de peticiones, con el estado HTTP y el mensaje originales. No se disimulan errores: se lean.
Alcance y versiones
Las tools cubren los seis módulos del SDK v1. AI, Webhooks y API Keys todavía no tienen tool propia. El paquete @nimobase/mcp-server se publica a la par que @nimobase/sdk: cualquier versión del MCP incluye el SDK con el que fue construida y probada.
Estado
Las configuraciones de cliente de más arriba fueron verificadas contra la documentación oficial de cada harness el 2026-11-02; no se han ejercitado de punta a punta contra un endpoint desplegado. El despliegue remoto se sigue por separado del paquete.