Cómo conectar Autotask PSA a Gemini — via MCP

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

Autotask PSA + Gemini

Autotask PSA de Datto (Kaseya): consulta empresas, contactos, tickets y notas, registros de tiempo, proyectos y tareas, recursos, contratos y elementos de configuración; crea y actualiza tickets, añade notas y registra tiempo. Autotask REST API.

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:

AUTOTASK_ZONE_HOST, AUTOTASK_USERNAME, AUTOTASK_SECRET, AUTOTASK_INTEGRATION_CODE

Paso 1 — Obtener credenciales

El conector usa la API REST de Autotask PSA. Necesita un recurso solo de API, que solo puede crear un administrador de Autotask.

1. En Autotask abre Admin → Resources/Users → New API User y asigna al recurso el nivel de seguridad API User (API-only).
2. En su pestaña Security, en API Tracking Identifier, elige tu proveedor de integración o deja que Autotask genere un identificador personalizado (internal integration). Cópialo en AUTOTASK_INTEGRATION_CODE.
3. Copia el nombre de usuario del usuario de API (un valor con forma de email) en AUTOTASK_USERNAME y el secreto generado en AUTOTASK_SECRET. El secreto solo se muestra completo al generarlo.
4. Abre https://webservices.autotask.net/atservicesrest/v1.0/zoneInformation?user=<API username> en el navegador y copia el host del campo url en AUTOTASK_ZONE_HOST, por ejemplo webservices5.autotask.net: solo el host, sin https:// y sin ruta. Una zona incorrecta responde 500 o 401 aunque las credenciales sean correctas.
5. Empieza con autotask_query_companies y luego autotask_query_tickets con companyID. Estado, prioridad y cola son ids numéricos que cambian en cada base de datos: léelos con autotask_get_entity_fields (por ejemplo, la entidad Tickets) antes de filtrar o escribir con ellos.

Una consulta devuelve como máximo 500 registros; Autotask permite 10.000 peticiones por hora y base de datos, así que para contar usa autotask_count_tickets. Crear y actualizar tickets, añadir notas y registrar tiempo cambia datos y puede disparar notificaciones a clientes mediante reglas de flujo de trabajo. Este conector no borra nada.

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 Gemini

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.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Autotask PSA.

Herramientas disponibles

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

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