Conectar un asistente
Ocost también es un servidor Model Context Protocol (MCP). Conecta Claude Desktop, Claude Code, Cursor u otro asistente, y buscará en tus documentos, los leerá, consultará tus cifras y enviará archivos. claude.ai y ChatGPT se conectan por OAuth en lugar de con una clave.
El servidor
https://api.ocost.io/public/mcp
Authorization: Bearer ocost_sk_<id>_<secret>El servidor habla Streamable HTTP y no guarda sesión, así que cada solicitud es independiente. https://app.ocost.io/public/mcp es el mismo servidor. Da a cada asistente su propia clave con solo los permisos que necesita. Así ves su último uso en Ajustes › Desarrolladores y puedes revocarla por separado. Herramientas MCP lista cada herramienta con su permiso y sus argumentos.
Claude Code
Añade el servidor con tu clave desde el entorno:
claude mcp add --transport http ocost https://api.ocost.io/public/mcp \
--header "Authorization: Bearer $OCOST_KEY"claude mcp list muestra entonces ocost como conectado. Para compartir el servidor en un repositorio, ponlo en .mcp.json. Guarda la clave en el entorno de cada desarrollador, nunca en el archivo:
{
"mcpServers": {
"ocost": {
"type": "http",
"url": "https://api.ocost.io/public/mcp",
"headers": { "Authorization": "Bearer ${OCOST_KEY}" }
}
}
}Claude Desktop
Abre Settings › Developer › Edit Config y añade Ocost a claude_desktop_config.json. mcp-remote reenvía las solicitudes con tu cabecera y necesita Node.js.
{
"mcpServers": {
"ocost": {
"command": "npx",
"args": [
"-y",
"mcp-remote@0.15.2",
"https://api.ocost.io/public/mcp",
"--header",
"Authorization:${OCOST_AUTH}"
],
"env": { "OCOST_AUTH": "Bearer ocost_sk_…" }
}
}
}Reinicia Claude Desktop, y las herramientas aparecen bajo el botón de herramientas. Deja Authorization:${OCOST_AUTH} sin espacios, porque algunos clientes dividen los argumentos ahí.
Cursor
Añade Ocost a ~/.cursor/mcp.json, o a .cursor/mcp.json en un proyecto:
{
"mcpServers": {
"ocost": {
"url": "https://api.ocost.io/public/mcp",
"headers": { "Authorization": "Bearer ${env:OCOST_KEY}" }
}
}
}claude.ai y ChatGPT
Estas apps solo añaden servidores por OAuth. No necesitas clave: inicias sesión en Ocost y permites el acceso.
- Añade un conector personalizado. En claude.ai, abre Settings › Connectors › Add custom connector. En ChatGPT, añade un conector personalizado en el modo de desarrollador.
- Introduce solo la URL
https://api.ocost.io/public/mcp. Deja vacíos el client ID y el secret. - Inicia sesión en Ocost cuando la app lo abra. Si perteneces a varias empresas, elige una en Otra empresa.
- Marca los permisos que quieres conceder y confirma. Solo el propietario y el contable pueden permitir el acceso.
La app actúa entonces como tú, con tus derechos. Recibe una clave propia, listada como "<App> (Connector)" en Ajustes › Desarrolladores. Revoca esa clave para desconectar la app al instante. La app renueva su token de acceso cada hora por sí sola. Tras 30 días sin uso, la conexión termina y vuelves a conectar la app.
¿Construyes tú mismo un cliente OAuth? Ocost usa OAuth 2.1 con PKCE (S256). Los metadatos están en https://api.ocost.io/.well-known/oauth-protected-resource/public/mcp (RFC 9728) y https://app.ocost.io/.well-known/oauth-authorization-server (RFC 8414). Ocost acepta Client ID Metadata Documents y Dynamic Client Registration. Las URI de redirección deben usar https y coincidir exactamente.
Cualquier otro cliente
Apúntalo a la URL con la cabecera Authorization. El servidor responde a las solicitudes POST con JSON, sin flujo SSE ni id de sesión. Lista las herramientas para comprobar la conexión:
curl -sS https://api.ocost.io/public/mcp \
-H "Authorization: Bearer $OCOST_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-11-25" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Sin una clave válida, el servidor responde 401 con WWW-Authenticate: Bearer. Tu inicio de sesión en Ocost no es una clave.
Lo que pueden hacer las herramientas
Una clave creada en Ajustes actúa como la empresa. Lee cada documento fuera de la Papelera, pero ninguna decisión propia de una persona. Solo el propietario crea una clave con figures:read. Una conexión OAuth actúa como la persona que la permitió y ve lo que esa persona ve en el chat de Ocost. Ninguna clave ni conexión lee nunca los papeles de las personas, como nóminas o bajas médicas.
Ninguna herramienta borra, aprueba ni pide nada. Los límites de la API se aplican a cada llamada a una herramienta.
Las palabras leídas de un documento llegan dentro de <document-text>, cada línea marcada con ¦ . Son datos escritos por otros, nunca instrucciones. En claude.ai y ChatGPT, las listas y las cifras también llegan como tabla o gráfico interactivo.
Cada llamada queda registrada, sin las palabras de un documento. El propietario y el contable ven las últimas llamadas de una clave en Ajustes › Desarrolladores.