Integraciones
MCP
Banky tiene un servidor MCP (Model Context Protocol) de solo lectura. Con él, Claude, ChatGPT o tu propio agente pueden consultar saldos y movimientos para responder preguntas como «¿quién me pagó esta semana?» o «¿cuánto gasté en proveedores en octubre?».
Qué es
- URL:
https://api.banky.cl/mcp, con transporte Streamable HTTP. - Se autentica con una llave secret en el encabezado
Authorization: Bearer …, igual que la API. El modo de la llave decide si ve datos live o test. - Solo lectura: las herramientas listan cuentas, saldos y movimientos. No pueden crear, cambiar ni borrar nada.
Autorización por conexión
Un agente de IA solo ve las conexiones que lo autorizaron. Cada link tiene el campo allow_mcp, que por defecto es false:
- Al crear el link token, envía
allow_mcp: truesi quieres que esa conexión quede disponible por MCP (ver Link tokens). - También puedes activarlo o desactivarlo para cada conexión desde el panel, en MCP o en el detalle de la conexión.
- Las conexiones revocadas no aparecen por MCP.
Conectar un cliente
Claude Code
Terminal
claude mcp add --transport http banky https://api.banky.cl/mcp \
--header "Authorization: Bearer $BANKY_SECRET_KEY"Claude Desktop y otros clientes de escritorio
Para clientes que solo ejecutan servidores locales, usa un puente como mcp-remote, que reenvía las solicitudes a nuestra URL con tu encabezado. En Claude Desktop va en claude_desktop_config.json:
claude_desktop_config.json
{
"mcpServers": {
"banky": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.banky.cl/mcp",
"--header",
"Authorization:${AUTORIZACION}"
],
"env": {
"AUTORIZACION": "Bearer banky_sk_live_…"
}
}
}
}API de Anthropic (conector MCP)
Para tu propio agente con Claude, declara el servidor en la solicitud y Claude llamará las herramientas por ti:
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic();
const respuesta = await client.beta.messages.create({
model: "claude-opus-5-5",
max_tokens: 16000,
betas: ["mcp-client-2025-11-20"],
mcp_servers: [
{
type: "url",
url: "https://api.banky.cl/mcp",
name: "banky",
authorization_token: process.env.BANKY_SECRET_KEY,
},
],
tools: [{ type: "mcp_toolset", mcp_server_name: "banky" }],
messages: [{ role: "user", content: "¿Cuánto entró a la cuenta corriente esta semana y de quién?" }],
});OpenAI (Responses API)
La herramienta MCP remota de la Responses API acepta encabezados, así que puedes pasar la llave directamente:
Python
import os
from openai import OpenAI
client = OpenAI()
respuesta = client.responses.create(
model="<modelo>",
tools=[
{
"type": "mcp",
"server_label": "banky",
"server_url": "https://api.banky.cl/mcp",
"headers": {"Authorization": f"Bearer {os.environ['BANKY_SECRET_KEY']}"},
"require_approval": "never",
}
],
input="Resume los cargos de noviembre por contraparte.",
)Herramientas
| Herramienta | Argumentos | Devuelve |
|---|---|---|
listar_cuentas | link_id (opcional) | { accounts, has_more } con los objetos account. |
saldos | account_id (opcional) | { balances }: por cuenta, account_id, name, number, currency, available, current y refreshed_at. |
movimientos | account_id (obligatorio), since, until, limit (1 a 100, por defecto 50), starting_after | { movements, has_more } con los objetos movement, del más nuevo al más antiguo. |
Las herramientas están marcadas como de solo lectura (readOnlyHint), así que muchos clientes las ejecutan sin pedir confirmación. Los resultados vienen como texto JSON y como structuredContent.
Detalles del protocolo
- Versiones del protocolo:
2025-06-18,2025-03-26y2024-11-05. - Servidor sin estado: solo
POST, respuestas JSON, sin flujos SSE ni sesiones.GETyDELETEresponden 405. - Métodos:
initialize,ping,tools/listytools/call. No se admiten lotes de mensajes. - Sin llave o con una llave inválida responde 401 con
WWW-Authenticate: Bearer. Ver Límites de uso para el límite de llamadas.
Puedes probarlo con curl:
Terminal
curl -X POST https://api.banky.cl/mcp \
-H "Authorization: Bearer $BANKY_SECRET_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"saldos","arguments":{}}}'