Cómo conectar Tabby a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Tabby, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Tabby + Cursor

Tabby, compra ahora y paga después (Emiratos Árabes Unidos, Arabia Saudí, Kuwait): consulta pagos con sus capturas y reembolsos, sesiones de checkout, disputas de clientes y webhooks. Captura, reembolso y cierre están incluidos, pero desactivados al instalar.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

TABBY_API_URL, TABBY_SECRET_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de comercio de Tabby y su clave secreta de API.

1. Inicia sesión en el Tabby Merchant Dashboard (merchant.tabby.ai para los Emiratos, merchant.tabby.sa para Arabia Saudí), o pide las claves de API a tu partner manager de Tabby.
2. Copia la secret key en TABBY_SECRET_KEY: sk_test_... para pagos de prueba, sk_... para pagos reales. La clave pública (pk_...) no funciona aquí.
3. Define TABBY_API_URL con la API de la región de tu comercio: https://api.tabby.ai para los Emiratos (y Kuwait), https://api.tabby.sa para Arabia Saudí. Tabby espera que cada llamada vaya a la región del comercio. Prueba y producción usan la misma dirección; la clave decide.
4. Instala el conector y ejecuta tabby_search_payments: lista tus últimos pagos y confirma la clave.

Id de pago y número de pedido: el id de un pago es un UUID que asigna Tabby; tu propio número de pedido es order.reference_id del pago. Para encontrar un pago a partir de un número de pedido, la IA lista los pagos de la fecha del pedido con tabby_search_payments (created_from / created_to) y busca order.reference_id.

Qué lee: tus pagos, del más reciente al más antiguo, con estado, monto y moneda, comprador (nombre, correo, teléfono), referencia y artículos del pedido, capturas y reembolsos; un pago completo, con dirección de envío, impuestos, envío, descuento y cada captura y reembolso con montos y fechas; sesiones de checkout, cuando el checkout de un cliente no terminó; disputas de clientes con motivo, comentario, adjuntos, artículos disputados y los días que faltan para su aprobación automática; y los webhooks registrados para un merchant code (no se devuelve el valor de su cabecera).

Estado del pago: AUTHORIZED significa que el cliente aprobó y aún no se capturó nada; CLOSED significa capturado por completo o cerrado; REJECTED y EXPIRED significan que no se movió dinero. Sin filtro de estado la búsqueda solo devuelve pagos AUTHORIZED y CLOSED.

Desactivadas al instalar: tabby_create_capture (captura un pago AUTHORIZED total o parcialmente cuando se envía el pedido), tabby_create_refund (reembolsa un pago CLOSED; el dinero vuelve al cliente al instante y no se puede recuperar) y tabby_close_payment (libera lo que no se capturó, para un pedido cancelado o tras una captura parcial). Mueven dinero, así que un administrador las activa a propósito. Incluso entonces la IA te muestra el pago, el monto y la moneda y espera tu sí, y pasa un reference_id para que un reintento no se ejecute dos veces.

Montos y horas: los montos son cadenas con hasta 2 decimales (AED, SAR) o 3 (KWD). Fechas y horas en UTC, ISO 8601.

Límites: la búsqueda de pagos devuelve como máximo 20 pagos por llamada, y la IA pagina con offset. La lista de disputas devuelve las 100 más recientes y pagina con un token.

Errores comunes: 401 significa una secret key incorrecta o una clave pública; un 400 con cuerpo vacío también puede ser una clave ausente. 403 o 404 en un pago que existe suele indicar la región equivocada en TABBY_API_URL. 409 en un reembolso significa que el pago aún no es reembolsable (no está CLOSED) o que el monto es demasiado alto.

El conector no crea sesiones de checkout, no modifica pagos, no registra webhooks ni responde disputas; eso se hace en el Tabby Merchant Dashboard.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Tabby.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué pagos de Tabby se crearon ayer, y cuáles siguen AUTHORIZED sin capturar?"
• "Encuentra el pago de Tabby de nuestro pedido número 100245 y muestra sus capturas y reembolsos."
• "Lista las disputas abiertas y cuántos días le quedan a cada una antes de su aprobación automática."
• "Un cliente dice que el checkout de Tabby no terminó: revisa esta sesión de checkout y dime qué pasó."
• "Reembolsa 120 AED del pago de Tabby del pedido 100245. Muéstrame antes el pago y el monto."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot