tu universo, en el loop de tu agente.

01Empieza aquí

El servidor MCP es parte del plan Pro. Con él, cualquier agente que hable MCP se convierte en una extensión de tu Virso: las mismas herramientas que el chat de la app, con sus propios permisos por agente y una cuota de 500 req/día para toda tu cuenta, aparte de la del chat.

1. Genera tu código en la appPerfil → Agentes conectados → elige tu agente y sus permisos. Virso te da un código de vinculación (formato XXXX-XXXX · 10 minutos · un solo uso · con o sin guion).ver el flujo en la app →
2. Agrega el servidor a tu agenteAñade https://mcp.virso.dev/mcp como conector — abajo tienes las configs más comunes. Tu agente abrirá una página de Virso.
3. Pega el código — listoSin usuario ni contraseña: el código es tu autenticación. El agente queda conectado con los permisos que elegiste. Pregúntale «¿cuánto tengo?» para probar.

el código reemplaza el login — nunca escribes una contraseña ✦

$ claude mcp add --transport http virso https://mcp.virso.dev/mcp
# luego, dentro de Claude Code: /mcp → virso → Authenticate

1  Agrega un conector personalizado
   Claude: Ajustes → Conectores · ChatGPT: activa antes el modo desarrollador
2  Pega la URL: https://mcp.virso.dev/mcp
3  Se abre la página de Virso → pega tu código — listo

URL         https://mcp.virso.dev/mcp
Transporte  Streamable HTTP · JSON-RPC 2.0 (stateless)
Auth        OAuth 2.1 + PKCE S256 · DCR ← el agente abre el navegador
Protocolo   2025-06-18 (también 2025-03-26 · 2024-11-05)
Métodos     initialize · tools/list · tools/call · ping

pégalo y pregúntale «¿cuánto tengo?» ✦

02Autorización

Sin contraseñas y sin registro manual: OAuth 2.1 + PKCE (S256) con registro dinámico de cliente (DCR). Y cada llamada revalida todo, en orden: conexión activa → suscripción Pro → permiso → cuota.

03Permisos

Cinco grupos; cada uno se concede como solo lectura, lectura + escritura o sin acceso (Balances es siempre solo lectura). En la app: Solo lectura · Todo · A mi manera — y lo cambias cuando quieras desde Perfil → Agentes conectados.

Los cambios son inmediatos y sin reautorizar: tools/list se filtra en vivo — el agente solo ve lo que concediste.

Escrituras: dos modos

lectura tranquila, escritura con permiso ✦

04Herramientas

Las 34 herramientas del asistente de la app, expuestas por MCP, más get_user_context, que es solo de MCP. Las marcadas con escribe requieren el permiso de escritura — si no lo diste, ni siquiera aparecen en su tools/list.

Fechas y contexto: los días y periodos (hoy, la semana pasada, este mes) son los de tu zona horaria; las marcas ISO que terminan en Z están en UTC. Tu agente debería llamar get_user_context al empezar y antes de resolver una fecha relativa. Cada resultado trae un sello «As of» (también en _meta["virso/asOf"]) con el momento en que se leyeron los datos, y las respuestas llegan en el idioma que elegiste en la app, o el de tu región si no elegiste uno.

05Límites

La cuota vive en tu cuenta, no en cada agente: 500 requests al día que tus agentes se reparten como tú quieras — uno solo puede usarlas todas, o cinco pueden compartirlas.

• Pasarte devuelve quota_exceeded — el agente descansa hasta la medianoche de tu zona horaria. Cada respuesta trae el header X-Virso-Quota: 489/500 con lo que te queda.
• Revocar un agente no devuelve lo que consumió: queda como «otros» hasta el reinicio del día.
• Las correcciones que haces dentro de la app nunca gastan cuota — esta cuota es solo para requests MCP.

06Errores y estados

Las fallas no rompen la conversación: vuelven como resultado de la herramienta con un código de máquina en _meta["virso/code"] y una explicación que tu agente lee y te cuenta. Los que verás:

07Changelog

Lo que va cambiando en el servidor.

esto apenas empieza ✦