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

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

Trybe + Microsoft Copilot

Trybe, la plataforma UGC basada en resultados para marcas: la lista de creadores y sus obligaciones de muestras, el rendimiento de los creadores (ganancias, GMV, inversión publicitaria, compras y ROAS en Meta, TikTok y AppLovin) y los vídeos que envían. La revisión de envíos está incluida, pero desactivada 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:

TRYBE_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de marca en Trybe con acceso a la Brand API y una API key de la marca.

1. El acceso a la API es una función de la cuenta de marca. Si todas las llamadas responden 403 feature_not_enabled, pide a tu contacto en Trybe que active la Brand API para tu marca.
2. Crea una API key para tu marca en el portal de marcas de Trybe, o pídesela a tu contacto en Trybe. Empieza por tk_live_. Pégala en TRYBE_API_KEY.
3. Instala el conector y ejecuta trybe_list_creators para comprobar la key.

La key se envía como Authorization: Bearer tk_live_... y solo ve tu marca.

Qué lee: los creadores activos de tu marca, primero los más recientes, con su estado de muestras en tu marca (muestras solicitadas, aprobadas, cumplidas y vencidas, la muestra pendiente de gestionar y el Sample Score), filtrables con sample_obligation=overdue para ver quién debe un vídeo; los programas de un creador con sus reglas de comisión, por ejemplo un 10 % del GMV más un importe fijo por pedido; el rendimiento de los creadores en un periodo (programas, última actividad, ganancias, conversiones y GMV de Trybe, envíos nuevos y activos, anuncios con su contenido, inversión publicitaria, compras, valor de compra y ROAS), ordenado con sort_by o limitado a un creador, un programa o a Meta, TikTok y AppLovin con platforms; y el contenido que envían los creadores, vídeo o imagen, con estado (pending, approved, rejected, revision_requested), creador, programa, productos, ángulos, transcripción, uso total en anuncios, miniatura y enlace de descarga. status=pending da la cola de revisión y query encuentra vídeos en los que se dice una palabra.

Desactivadas al instalar: trybe_approve_submission, trybe_reject_submission y trybe_request_submission_revision, que necesita un comment que diga al creador qué cambiar. El creador recibe un aviso al momento y la aprobación afecta a lo que gana, así que un administrador las activa a conciencia. Incluso entonces la IA te muestra el envío y el comentario y espera tu sí.

Leer las cifras: los campos de dinero terminan en _cents y son centavos de dólar estadounidense (spend_cents 250000 son 2.500,00 USD). Las fechas son días naturales UTC YYYY-MM-DD y end_date no puede estar en el futuro. Sin fechas, el rendimiento cubre los últimos 30 días UTC completos; ordenar por una métrica o active_only=true limita la ventana a 90 días. roas es el valor de compra dividido entre la inversión, null si no hay inversión. Un bloque samples a cero significa que no hay muestras; null significa que no se pudo leer en esa petición, así que la IA vuelve a intentarlo en lugar de tomarlo como vacío.

Ids y anuncios: los creadores son creator_<uuid>, los programas creator_program_<uuid>, los envíos submission_<uuid>, los productos product_<uuid> y los grupos subgroup_<uuid>, usados tal cual se devuelven. El trybe_id de un envío (sus últimos 8 caracteres) debe aparecer en la URL de destino y en el nombre de cada anuncio creado a partir de él: así atribuye Trybe los anuncios y paga a los creadores.

Límites: las listas devuelven 20 filas por defecto y como máximo 100 (limit), y la IA pagina con after = next_cursor mientras has_more sea true. La API permite 300 peticiones por ventana y por encima responde 429 rate_limit_exceeded. Los enlaces de descarga de asset.url caducan a los 20 minutos aproximadamente, así que la IA pide uno nuevo en lugar de guardarlo.

Errores comunes: 401 invalid_api_key indica una key ausente o incorrecta. 403 feature_not_enabled significa que la Brand API no está activada para tu marca. 400 validation_error nombra el parámetro erróneo, por ejemplo una fecha de inicio posterior a la de fin. Un 404 en un id concreto significa que no existe o pertenece a otra marca.

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 Trybe.
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é creadores nos deben un vídeo ahora mismo? Lístalos con sus muestras vencidas."
• "Ordena a nuestros creadores por valor de compra en los últimos 30 días y muestra la inversión y el ROAS de cada uno."
• "¿Qué tal les fue a nuestros creadores en TikTok el mes pasado? Muestra ganancias, inversión publicitaria y compras."
• "Lista los envíos pendientes y resume la transcripción de cada uno."
• "Busca envíos que mencionen el envío gratuito y dime cuánto los han usado los anuncios."

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