Conectar Podio MCP con Microsoft Copilot

💡 ¿No quieres instalar nada? Usa directamente cloud.anythingmcp.com. Inicia sesión, haz clic en Connectors → Podio, pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Podio + Microsoft Copilot

Lee una app de Podio: sus definiciones de campos, una página filtrada de elementos y un único elemento. Inicia sesión con la autenticación de app de Podio. Solo lectura.

Requisitos previos

Consulta las instrucciones de configuración completas incluidas en el conector (visibles en la tienda de la aplicación al seleccionar el conector). Las variables de entorno necesarias para este conector son:

PODIO_APP_ID, PODIO_APP_TOKEN, PODIO_CLIENT_ID, PODIO_CLIENT_SECRET

Paso 1 — Obtén las credenciales

La configuración lleva unos 5 minutos. Necesitas una clave de API de Podio (client id y secret), además del App ID y el App token de la única app de Podio que la IA debe leer.

1. Abre https://podio.com/settings/api y genera una clave de API. Copia el client id en PODIO_CLIENT_ID y el client secret en PODIO_CLIENT_SECRET. Podio muestra el secret una sola vez.
2. Abre la app de Podio, luego el menú de la llave inglesa y después Developer. Copia el App ID en PODIO_APP_ID y el App token en PODIO_APP_TOKEN.
3. Instala el conector y ejecuta podio_get_app: inicia sesión y devuelve el nombre de la app y todos sus campos.

Una sola app: los cuatro valores inician sesión del conector como esa app (autenticación de app de Podio). El token de acceso dura 8 horas y el conector vuelve a iniciar sesión por sí solo cuando caduca. Las demás apps del espacio de trabajo quedan fuera de alcance: una llamada fuera de la app devuelve 403. La API de Podio es pública, así que esto funciona en AnythingMCP Cloud y en instancias autoalojadas.

Qué lee: podio_get_app devuelve cada campo con su field_id, external_id, tipo, etiqueta, indicador de obligatoriedad y ajustes, como los ids de las opciones de categoría. podio_filter_items lista una página de elementos con los valores de sus campos. podio_get_item abre un elemento por el item_id numérico de esa lista (no el app_item_id). Leer un elemento no lo marca como visto, por lo que no borra tus notificaciones de Podio.

Filtros y páginas: la IA filtra por el external_id de un campo, o por title, created_on, created_by, last_edit_on, tags, item_id, app_item_id o external_id. Los valores de categoría son ids de opción; los números, el dinero y las fechas admiten un rango desde/hasta, y las fechas pueden ser relativas, como -7d o +1w. Los campos de texto no se pueden filtrar, salvo el título del elemento mediante title. Una página contiene 20 elementos por defecto y hasta 100.

Límites: Podio cuenta las llamadas por clave de API y hora: 250 para podio_filter_items y 1.000 para el resto de lecturas. Al superar el límite, Podio responde con HTTP 420 (no 429) y la IA espera antes de volver a intentarlo.

Errores comunes: un 400 al iniciar sesión significa que el client id, el client secret, el App ID y el App token no corresponden entre sí. Un 401 significa que Podio rechazó el token de acceso: guarda de nuevo el conector para que inicie sesión otra vez y revisa los cuatro valores. Un 403 significa que la llamada salió de la única app que este token puede leer. Un 404 significa que no existe ninguna app ni elemento con ese id.

El conector no crea ni edita elementos, no lee comentarios ni archivos, no abre otras apps y no inicia sesión como usuario de Podio.

Paso 2 — Instala el adaptador

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ñade 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 Podio.
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

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