Lane · Documentación

Plataforma

Servidor MCP

Tu asistente con la documentación de Lane adentro: la busca, la lee y sigue la guía de integración por ti.

MCP —Model Context Protocol— es la forma estándar de darle herramientas a un asistente. El servidor de Lane le da la documentación completa: en vez de copiarle páginas, le pides «integra Lane en mi tienda» y él arma el plan, consulta cada endpoint antes de usarlo y respeta las reglas que más cuestan cuando se olvidan.

Conectarlo

Es público y solo lee documentación: no pide llave, no ve tu cuenta y no puede cobrar nada.

Qué le da a tu asistente

Trae además dos instrucciones listas para usar. En Claude Code aparecen como comandos: /mcp__lane__integrar_lane arma la integración en tu proyecto, en sandbox y paso a paso; /mcp__lane__revisar_integracion revisa una integración ya escrita y señala lo que puede cobrar mal o despachar un pedido sin pago confirmado.

Prueba con esto. «Integra Lane en este proyecto para cobrar con link de pago y avísame cuando el pago se apruebe.» El asistente pide la guía, lee el endpoint, pone la llave sk_test_ en una variable de entorno y escribe el webhook con la firma verificada.

Especificación

Lo que necesitas si conectas un cliente propio. Los clientes de la sección anterior ya lo resuelven solos.

Herramientas

Todas solo leen, y ninguna toca la API ni tu cuenta: van marcadas readOnlyHint e idempotentHint, así que un cliente no debería pedir confirmación para usarlas.

guia_de_integracion

buscar_documentacion

leer_pagina

listar_paginas no recibe parámetros. Todas responden en markdown dentro de un bloque text.

convertir_monto

medios_para_monto

validar_peticion

explicar_error

explicar_evento

novedades

Nunca le mandes una llave a este servidor. Ninguna herramienta la necesita: no tocan la API ni tu cuenta, solo comparan lo que les mandas con esta documentación. Si una llave sk_ o un secreto whsec_ llega pegado en un cuerpo, la herramienta lo dice y no lo repite, pero ya salió de tu servidor: rótalo. El servidor acepta hasta 120 peticiones por minuto por dirección; pasarse responde 429.

Prompts

Recursos

Cada página de esta documentación es un recurso, con su URL en markdown como URI —por ejemplo https://lane.money/docs/webhooks.md— y tipo text/markdown. resources/list las devuelve todas y resources/read devuelve el contenido.

Errores

Probarlo sin cliente

curl -X POST https://lane.money/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "buscar_documentacion",
      "arguments": { "consulta": "firma del webhook", "limite": 2 }
    }
  }'

Inspeccionarlo con el cliente oficial

npx @modelcontextprotocol/inspector --cli https://lane.money/mcp --transport http --method tools/list

Consultar tu cuenta de prueba

Un segundo servidor, aparte del de documentación, deja que tu asistente mire tu cuenta: «¿llegó el cobro de prueba que acabo de hacer?», «¿cuáles de mis comercios ya pueden cobrar?». Solo lee, y solo en modo de prueba.

Lo que no puede hacer

• No escribe. No crea cobros ni links, no reembolsa y no cambia nada: el servidor no tiene con qué. Todas sus peticiones a la API son GET.
• No usa llaves reales. Solo acepta una sk_test_. Una sk_live_ se rechaza sin llegar a la API.
• No entrega los datos del comprador. El correo y el nombre salen enmascarados (a•••@tienda.co, A. P.); el documento, el teléfono y los identificadores de una tarjeta no salen.
• No entrega la dirección de un enlace de registro, que es el permiso para usarlo.
• No obedece lo que lee. Lo que escribió un comprador o un comercio (un nombre, una referencia, tu metadata) llega recortado y marcado como texto_de_terceros: un dato para mostrar, no una instrucción.
• No guarda nada. Ni la llave, ni lo que consultas.

Dos formas de conectarlo

Remoto, en Claude Code

claude mcp add --transport http lane-cuenta https://lane.money/mcp/cuenta \
  --header "Authorization: Bearer $LANE_SECRET_KEY"

En tu máquina

curl -O https://lane.money/mcp/lane-cuenta.mjs
claude mcp add lane-cuenta --env LANE_SECRET_KEY=sk_test_… -- node lane-cuenta.mjs

El archivo es uno solo y no tiene dependencias: es el mismo que corre detrás de la URL, y puedes leerlo entero antes de darle tu llave. En otros clientes, es un servidor de stdio con el comando node lane-cuenta.mjs y la variable LANE_SECRET_KEY. En el remoto, la llave va en la cabecera Authorization: Bearer sk_test_…: sirve en los clientes que dejan poner una cabecera.

Lo que todavía no hace. No consulta en modo real y no opera la cuenta: crear un link o reembolsar desde un asistente no está disponible. Eso llegará cuando existan llaves de alcance limitado y una confirmación humana para lo que mueve plata.

Sin MCP

Si tu asistente no habla MCP, la misma documentación está publicada en markdown limpio.

Cómo escribimos esta documentación

Está pensada para que la lea una máquina sin perder nada: cada endpoint es autocontenido —no dice «como se vio arriba»—, los campos van en tablas y no en párrafos, cada ejemplo se puede copiar y ejecutar tal cual, y los montos aparecen siempre en las dos formas, el entero que se manda y los pesos que ve el comprador. El servidor MCP lee exactamente estas páginas: lo que ve tu asistente es lo que ves tú.

Esta página en markdown: /docs/mcp.md · Toda la documentación: /docs/llms-full.txt