Cómo conectar Tabby a Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Tabby.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

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