MCP (Model Context Protocol) permite que asistentes de IA como Claude, Cursor, VS Code Copilot, Codex, Gemini o Windsurf trabajen con tus datos de Okinta: leer contactos, pedidos y facturas, consultar tus informes y crear o actualizar datos cuando lo permitas. Cualquier app compatible con servidores MCP remotos puede conectarse.
Ve a Ajustes → API y crea una clave solo con los permisos que necesita el asistente (de solo lectura para empezar). Para probar sin riesgo, crea una clave de prueba (okt_test_…): solo llega a tu entorno de pruebas.
https://api.okinta.io/mcpPega el texto de abajo en Cursor, Claude, ChatGPT (con MCP) o en cualquier asistente que pueda editar la configuración MCP. Cuando pida tu clave, pégala desde Ajustes → API (usa un marcador en los archivos de config, no el secreto real en git).
Conecta Okinta como servidor MCP remoto en esta app.
- URL: https://api.okinta.io/mcp
- Transporte: HTTP (remoto / Streamable HTTP)
- Cabecera de autenticación: Authorization: Bearer YOUR_KEY
Elige el archivo de configuración adecuado para esta app (por ejemplo ~/.cursor/mcp.json en Cursor) y añade el servidor con esa cabecera. Te daré la clave API en el siguiente mensaje cuando la pidas.
Cuando termines, lista las herramientas MCP de Okinta para confirmar que funciona.claude mcp add --transport http okinta https://api.okinta.io/mcp \
--header "Authorization: Bearer YOUR_KEY"Añade esto a claude_desktop_config.json (Ajustes → Desarrollador → Editar configuración):
{
"mcpServers": {
"okinta": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.okinta.io/mcp", "--header", "Authorization:${OKINTA_AUTH}"],
"env": { "OKINTA_AUTH": "Bearer YOUR_KEY" }
}
}
}La mayoría de apps aceptan la dirección del servidor y una cabecera Authorization en sus ajustes MCP (a menudo mcp.json). Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"okinta": { "url": "https://api.okinta.io/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } }
}
}Añade esto a .vscode/mcp.json o ejecuta MCP: Open User Configuration:
{
"servers": {
"okinta": { "type": "http", "url": "https://api.okinta.io/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } }
}
}Añade esto a ~/.codeium/windsurf/mcp_config.json (Windsurf llama a la dirección serverUrl):
{
"mcpServers": {
"okinta": { "serverUrl": "https://api.okinta.io/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } }
}
}Guarda la clave en una variable de entorno y añade esto a ~/.codex/config.toml:
export OKINTA_API_KEY=YOUR_KEY
[mcp_servers.okinta]
url = "https://api.okinta.io/mcp"
bearer_token_env_var = "OKINTA_API_KEY"Añade esto a ~/.gemini/settings.json:
{
"mcpServers": {
"okinta": { "httpUrl": "https://api.okinta.io/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } }
}
}Si una app solo admite servidores locales (stdio), usa el puente mcp-remote:
npx -y mcp-remote https://api.okinta.io/mcp \
--header "Authorization: Bearer YOUR_KEY"list_contacts, get_invoice, create_expense, issue_quote, get_profit_and_loss_report…Conectar en un clic, sin copiar una clave (iniciar sesión con Okinta), para las apps que necesitan OAuth.
El servidor MCP usa las mismas claves, permisos y límites que la API: un asistente nunca llega más lejos de lo que el creador de la clave puede abrir en la aplicación. Revoca la clave en Ajustes → API para desconectarlo al instante.