Conectar MOCO MCP con Microsoft Copilot

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

MOCO + Microsoft Copilot

Deja que tu IA trabaje con tu cuenta de MOCO: consulta proyectos y clientes, revisa las horas registradas por persona o proyecto, comprueba las facturas pendientes y la ocupación del equipo y registra horas. Con tu subdominio de MOCO y una clave API de tu perfil de MOCO.

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:

MOCO_SUBDOMAIN, MOCO_API_KEY

Paso 1 — Obtener credenciales

1. En MOCO, haz clic en tu foto de perfil arriba a la derecha, abre la pestaña Integrations de tu perfil y copia tu clave API personal. Llega exactamente a lo que tu propio usuario de MOCO puede ver y hacer.
2. Como alternativa, crea una clave API de la cuenta en Settings → Extensions → API & Webhooks → API Keys, con acceso de solo lectura o completo. Una clave de solo lectura no puede registrar horas.
3. Pega la clave en MOCO_API_KEY.
4. Pon en MOCO_SUBDOMAIN solo la primera parte de tu dirección de MOCO: para agency.mocoapp.com escribe agency, sin https:// y sin .mocoapp.com. El conector llamará entonces a https://agency.mocoapp.com/api/v1.
5. Instala el conector. No hay paso Authorize with Provider: la clave se guarda cifrada y se envía en cada petición.
6. Empieza con moco_list_users: si muestra a tus compañeros con sus ID, la clave y el subdominio son correctos.

Mantener la sesión iniciada: el conector usa la clave directamente, así que no hay ningún inicio de sesión que renovar. Si la clave se sustituye o se elimina en MOCO, pega la nueva en MOCO_API_KEY.

Qué ve la IA: cada lista devuelve solo los registros que el usuario de la clave puede ver. Si parece que falta un proyecto o una factura, suele ser una cuestión de permisos en MOCO, no un fallo del conector.

Registrar horas: moco_create_activity es la única herramienta que escribe en MOCO. Registra una entrada de tiempo para el usuario al que pertenece la clave, con fecha, ID del proyecto, ID de la tarea, duración en segundos enteros (2 horas son 7200) y una descripción opcional. La IA encuentra el proyecto con moco_list_projects y sus tareas con moco_get_project. Cada llamada crea una entrada nueva y una llamada repetida registra el tiempo dos veces, así que la IA te muestra antes fecha, proyecto, tarea y duración y espera tu sí.

Permisos y solo lectura: para un conector que solo lea, desactiva moco_create_activity en la página del conector o usa una clave API de la cuenta con acceso de solo lectura. No des una clave con acceso completo a quien solo deba leer datos.

Informes y facturas: moco_list_activities y moco_report_utilization necesitan siempre una fecha de inicio y una de fin (from y to, con el formato YYYY-MM-DD). Las entradas de tiempo se pueden limitar a una persona, a un proyecto o solo a las horas facturables; el informe de ocupación compara la capacidad disponible con la reservada. moco_list_invoices filtra por estado (draft, created, sent, partially_paid, paid, overdue, ignored, también varios separados por comas), fecha de factura y empresa.

Límites: las listas devuelven hasta 100 entradas por página y la IA sigue pasando páginas hasta la última. MOCO permite unas 120 peticiones cada dos minutos en los planes estándar; por encima responde 429, así que espera un momento y vuelve a intentarlo.

Errores frecuentes: 401 significa que la clave es incorrecta, se eliminó o pertenece a una cuenta de MOCO distinta de la de MOCO_SUBDOMAIN. Si fallan todas las llamadas, comprueba que MOCO_SUBDOMAIN contiene solo el subdominio y no la dirección completa. 404 en un proyecto concreto significa que el ID es incorrecto o que el usuario de la clave no puede ver ese proyecto. Un registro rechazado indica el campo que MOCO no aceptó, por ejemplo una tarea que no pertenece al proyecto.

El conector no crea ni envía facturas, no descarga PDF, no configura webhooks, no edita ni elimina entradas de tiempo y no modifica proyectos, empresas ni usuarios.

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

• "¿Cuántas horas registró el equipo en el proyecto Website Relaunch en septiembre y cuántas de ellas eran facturables?"
• "¿Qué facturas están vencidas o pagadas solo en parte ahora mismo, y a qué clientes pertenecen?"
• "¿Cómo fue la ocupación del equipo el mes pasado? Compara la capacidad disponible con la reservada."
• "Registra hoy 2,5 horas en el proyecto web de Acme para la revisión del diseño de la página de inicio. Enséñame la entrada antes de registrarla."

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