Cómo conectar MOCO a ChatGPT vía MCP

💡 ¿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 + ChatGPT

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 ChatGPT

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.

ChatGPT se conecta a servidores MCP como apps personalizadas en modo desarrollador (Developer mode), disponible en los planes de pago, no en el gratuito. En los espacios Business y Enterprise puede que un administrador tenga que habilitarlo antes.

1. En ChatGPT, abre Settings → Security and login y activa Developer mode.
2. Ve a chatgpt.com/plugins y pulsa +.
3. Escribe un nombre y una descripción breve, por ejemplo Name: MOCO.
4. En Connection, introduce la URL del servidor MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y crea la conexión.
5. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP (OAuth) y permite el acceso.

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

¿Funciona el plan gratuito de ChatGPT con conectores MCP personalizados? No. Las conexiones MCP personalizadas necesitan el modo desarrollador, que solo está en los planes de pago.

Siguientes pasos

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