Saltar al contenido

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: true si 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

HerramientaArgumentosDevuelve
listar_cuentaslink_id (opcional){ accounts, has_more } con los objetos account.
saldosaccount_id (opcional){ balances }: por cuenta, account_id, name, number, currency, available, current y refreshed_at.
movimientosaccount_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-26 y 2024-11-05.
  • Servidor sin estado: solo POST, respuestas JSON, sin flujos SSE ni sesiones. GET y DELETE responden 405.
  • Métodos: initialize, ping, tools/list y tools/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":{}}}'