Cómo conectar Tamara a Microsoft Copilot vía MCP

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

Tamara + Microsoft Copilot

Tamara, compra ahora y paga después (Arabia Saudí, Emiratos Árabes Unidos, Kuwait, Baréin, Omán): consulta pedidos por tu número de pedido o el id de Tamara con estado y montos capturados, reembolsados y liquidados, y comprueba los tipos de pago y la elegibilidad del cliente. Captura y reembolso 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:

TAMARA_API_URL, TAMARA_API_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de comercio de Tamara y su token de API.

1. Inicia sesión en el Tamara Partners Portal y abre API Token Management, o usa el token de API que Tamara te envió con tu cuenta de comercio. Sandbox y producción tienen tokens distintos.
2. Pega el token en TAMARA_API_TOKEN, sin "Bearer" ni espacios. Se envía como Authorization: Bearer <token>. El notification token y la clave pública no se usan aquí.
3. Define TAMARA_API_URL como https://api.tamara.co para producción o https://api-sandbox.tamara.co para el sandbox. Debe coincidir con el token.
4. Instala el conector y ejecuta tamara_list_payment_types: lista los tipos de pago que ofrece tu tienda y confirma el token.

Tu número de pedido o el id de Tamara: order_reference_id es tu propio número de pedido enviado en el checkout, por ejemplo el número de pedido de la tienda; order_id es el UUID que emitió Tamara. La mayoría de las preguntas parten de tu número de pedido, con tamara_get_order_by_reference.

Qué lee: un pedido por tu número de pedido o por el id de pedido de Tamara, con estado, tipo de pago y cuotas, cliente, direcciones, artículos, total, montos capturados, reembolsados, cancelados y pagados, estado y fecha de liquidación, y sus transacciones (capturas, reembolsos y cancelaciones); los tipos de pago disponibles en un país (como PAY_BY_INSTALMENTS o PAY_NOW) con monto mínimo y máximo del pedido y número de cuotas admitidas, opcionalmente solo los válidos para un monto; antes del checkout, qué opciones de pago puede usar un cliente concreto para un monto, y si Tamara considera ahora elegible a un cliente (por teléfono, correo o ambos); y un webhook registrado con su URL, eventos y cabeceras.

Estado del pedido: new, approved, authorised, luego partially_captured o fully_captured, y partially_refunded o fully_refunded; canceled, declined y expired son definitivos. paid_amount es lo que el cliente ha pagado hasta ahora; settlement_status y settlement_date indican si Tamara ya te ha liquidado.

Desactivadas al instalar: tamara_capture_order (captura un pedido autorizado total o parcialmente cuando se envía, para que Tamara lo liquide) y tamara_refund_order (reembolsa un pedido capturado total o parcialmente; el dinero vuelve al cliente y no se puede recuperar). Ambas mueven dinero, así que un administrador las activa a propósito. Incluso entonces la IA te muestra el pedido, el monto y la moneda y espera tu sí.

Montos y horas: los montos son objetos con amount y currency; SAR y AED tienen 2 decimales, BHD, KWD y OMR 3. Las horas están en UTC, ISO 8601.

Límites: Tamara no tiene un endpoint para listar o buscar pedidos, así que la IA los consulta por tu número de pedido o por el id de Tamara.

Errores comunes: 401 significa un token incorrecto o un token del otro entorno (sandbox o producción). 404 en un pedido significa que en este entorno no hay ningún pedido con esa referencia o id. 400 o 422 en una captura o un reembolso nombran el campo que Tamara rechazó, por ejemplo un monto mayor que lo que se puede capturar. 403 significa que el token funciona pero no puede usar esta API; pide a Tamara que la active para tu cuenta de comercio.

El conector no crea sesiones de checkout, no autoriza ni cancela pedidos, no usa la claims API ni descarga reportes de liquidación.

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 Tamara.
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

• "¿En qué estado está nuestro pedido 100245 en Tamara, y ya nos lo ha liquidado Tamara?"
• "¿Cuánto del pedido 100245 se ha capturado, reembolsado y pagado por el cliente hasta ahora?"
• "¿Qué tipos de pago de Tamara ofrece nuestra tienda en Arabia Saudí para un pedido de 1.200 SAR?"
• "¿Puede el cliente con el teléfono +966501234567 pagar 800 SAR con Tamara?"
• "El pedido 100245 ya se envió: captúralo completo. Muéstrame antes el pedido 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