Servidor MCP

Conectá Claude, ChatGPT o cualquier agente de IA compatible con MCP a tu cuenta de YoFacturo y operá tu negocio de forma conversacional: consultá ventas, creá clientes, emití presupuestos, registrá gastos y mucho más.

¿Qué es MCP?

Model Context Protocol (MCP) es un estándar abierto que conecta modelos de IA con herramientas externas. El servidor MCP de YoFacturo expone las mismas operaciones que el asistente de IA integrado en el panel, accesibles desde cualquier cliente MCP: Claude Desktop, Claude Code, claude.ai, Cursor, VS Code, ChatGPT (vía conectores) o tu propio agente.

No lo confundas con los API tokens (yf_live_…), que son una funcionalidad exclusiva del plan Premium para integraciones REST personalizadas — ver Autenticación. El servidor MCP es más accesible: está disponible desde el plan Básico (las cuentas en período de prueba también tienen acceso).

Cómo conectar tu cliente MCP

URL del servidor:

https://api.yo-facturo.com/api/v1/mcp

• Transporte: Streamable HTTP (JSON-RPC 2.0).
• Autenticación: OAuth 2.1 con PKCE (S256) y Registro Dinámico de Clientes (Dynamic Client Registration, RFC 7591) — tu cliente MCP se registra solo, no hace falta crear nada a mano.
• Versión del protocolo: 2025-06-18 (también negocia 2025-03-26 y 2024-11-05 para clientes más viejos).

Agregá esa URL como servidor MCP remoto en tu cliente. La primera vez que te conectás:

1. El cliente abre tu navegador en YoFacturo.
2. Iniciás sesión con tu cuenta (si todavía no lo hiciste).
3. Revisás los permisos (scopes) solicitados y autorizás la conexión.
4. El cliente recibe sus credenciales y queda conectado — no hay tokens para copiar ni pegar.

Claude Code

claude mcp add --transport http yofacturo https://api.yo-facturo.com/api/v1/mcp

Al primer uso, Claude Code abre el navegador para que autorices la conexión.

Claude Desktop / claude.ai

Agregá un conector / servidor MCP remoto apuntando a la URL de arriba. El cliente detecta automáticamente que el servidor requiere OAuth (vía los documentos de discovery en /.well-known/) y dispara el flujo de autorización en el navegador.

Clientes MCP genéricos

Cualquier cliente MCP que soporte transporte HTTP remoto con OAuth 2.1 puede conectarse. El formato exacto de configuración varía según el cliente; un ejemplo típico:

curl -X POST https://api.yo-facturo.com/api/v1/mcp \
  -H "Authorization: Bearer TU_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Permisos (scopes)

Durante la autorización se muestran los permisos que el cliente solicita. Podés conceder solo lectura, o lectura + escritura.

Si conectás en modo solo lectura, el cliente puede consultar datos pero nunca modificarlos: el servidor rechaza cualquier herramienta de escritura con un error explícito.

Herramientas disponibles

El servidor expone 76 herramientas — el mismo conjunto que usa el asistente de IA integrado en el panel. Qué herramientas ve cada conexión depende de dos cosas:

• Tu plan y los módulos habilitados en tu cuenta: solo aparecen las herramientas de las funciones que tenés activas (por ejemplo, sin el módulo de Alquileres no vas a ver esas herramientas).
• El scope concedido: las herramientas que crean o modifican datos (columna «Tipo» = Escritura) solo están disponibles si concediste yofacturo:write.

Las herramientas de escritura le piden al asistente que confirme los datos con vos antes de ejecutarse — el servidor nunca crea ni modifica algo sin que lo veas primero.

Seguridad

• OAuth 2.1 + PKCE (S256): flujo de autorización estándar, vinculado a tu cuenta. El servidor rechaza el transform plain de PKCE.
• Tokens de acceso de corta duración (1 hora), renovables con un refresh token rotativo: cada renovación invalida el refresh token anterior.
• Revocación inmediata: al revocar una conexión desde el panel, el acceso se corta de inmediato — el servidor verifica la revocación en cada llamada, independientemente del token.
• Toda conexión queda vinculada a tu cuenta y a tu empresa: el servidor MCP nunca da acceso fuera del alcance de tu cuenta.
• El servidor re-verifica tu plan y tu suscripción en cada resolución de contexto: si tu suscripción vence o bajás de plan, las conexiones existentes dejan de funcionar.
• Los redirect_uri se validan por coincidencia exacta contra los registrados por el cliente (sin comodines) y solo se aceptan esquemas https, esquemas de app nativa (cursor://, vscode://, etc.) o http en loopback (localhost, 127.0.0.1).

Límites de uso

Cada conexión MCP tiene límites de frecuencia por ventana, para evitar abusos:

Superar cualquier ventana devuelve un error 429 temporal con el header Retry-After. Más detalle sobre el manejo de errores en Manejo de errores.

Gestionar tus conexiones

Desde Configuración → Integraciones → Servidor MCP podés ver todas las conexiones vinculadas a tu cuenta (cliente, fecha de conexión, última actividad) y revocar cualquiera de ellas — el acceso se corta de inmediato, sin afectar a las demás. Cada cuenta puede tener hasta 25 conexiones activas.

Troubleshooting