Atako MCP

Atako MCP

Conecta Claude Code, Claude Desktop, Cursor o ChatGPT a tu cuenta de Atako mediante el Model Context Protocol.

Atako ejecuta un servidor Model Context Protocol (MCP) en https://api.atako.ai/mcp, de modo que un cliente de IA que ya uses (Claude Code, Claude Desktop, Cursor, modo desarrollador de ChatGPT o cualquier otro cliente MCP) pueda leer y actuar sobre tu cuenta de Atako directamente: tus agentes, su historial de chat y archivos, conexiones de integraciones, actividad, créditos y suscripción.

Nota

La mayoría de las herramientas leen el estado existente. Algunas ahora también escriben: crear, renombrar, finalizar y reanudar agentes; enviar un mensaje y esperar la respuesta; subir un archivo a un agente; conectar una integración y otorgarla a un agente. Dos cosas aún requieren que estés en un navegador: una conexión de integración OAuth necesita tu consentimiento en la propia página del proveedor, y cualquier cambio de facturación/suscripción ocurre en app.atako.ai; ninguna herramienta puede hacerlo por ti.

Salta a la guía de inicio rápido para configuraciones de cliente copiables y pegables.

Conexión

Necesitas una clave API programática (aik_…) desde Configuración → Claves API. Apunta tu cliente MCP a la URL a continuación con esa clave como token Bearer:

URL:     https://api.atako.ai/mcp
Header:  Authorization: Bearer aik_...

El transporte es Streamable HTTP (el transporte recomendado por la especificación MCP actual); no requiere instalación adicional para la mayoría de los clientes, ya que lo soportan de forma nativa.

Una clave actúa como su usuario propietario: un cliente MCP conectado con tu clave puede hacer exactamente lo que tú podrías hacer al iniciar sesión en la aplicación: leer y gestionar tus propios agentes, además de cualquier agente creado por tus compañeros de equipo al que tengas acceso mediante un equipo compartido o visibilidad a nivel de empresa.

Pruébalo

Algunas cosas que puedes pedir, una vez conectado:

• "Enumera mis agentes de Atako y dime cuáles están inactivos."
• "Crea un agente que clasifique mis tickets de Zendesk y redacte respuestas."
• "Envía un mensaje a mi agente de soporte pidiendo el recuento de tickets de hoy y espera su respuesta."
• "Conecta mi token de GitHub y otórgalo a mi agente de ingeniería, solo lectura."
• "¿Cuál es mi saldo de créditos y cuántos puestos de agente me quedan?"

Herramientas

Lectura

Herramienta	Qué devuelve
list_agents	Cada agente que puedes ver, con estado y una vista previa del último mensaje
get_agent	Detalle completo de un agente
whoami	Tu identidad, empresa y plan de suscripción
list_messages	Tu historial de chat con un agente
wait_for_reply	Bloquea (hasta 25 s) la siguiente respuesta de un agente; llámalo justo después de send_message
list_cron_jobs	Las tareas programadas recurrentes de un agente y su historial de ejecución
list_sub_agents	Subagentes que un agente ha creado para delegar trabajo
list_interagent_messages	Mensajes que un agente intercambió con compañeros de la empresa
list_activity	La línea de tiempo de actividad en vivo de un agente (turnos, llamadas a herramientas, subagentes)
get_activity_state	Si un agente está trabajando actualmente
list_agent_files	Archivos a los que un agente puede acceder actualmente
list_integration_catalog	Cada integración de terceros que Atako soporta
list_integration_connections	Tus propias integraciones conectadas
list_agent_integration_grants	Qué conexiones puede usar un agente y cómo
get_connect_url	Inicia una conexión OAuth y devuelve la URL para abrir en un navegador
get_credits	El saldo de créditos de tu empresa y el consumo de este período
get_subscription	El plan de tu empresa, su estado y el uso de puestos de agente
list_models	Modelos de IA disponibles al crear/configurar un agente
list_harnesses	Entornos de ejecución disponibles al crear un agente

Escritura

Herramienta	Qué hace
create_agent	Crea un nuevo agente; solo se requiere name
update_agent_name	Renombra un agente
end_agent	Finaliza un agente activo, liberando su puesto
resume_agent	Reanuda un agente en pausa
cancel_agent_provisioning	Cancela un agente que aún se está aprovisionando
retry_agent_provisioning	Reintenta un aprovisionamiento fallido
send_message	Envía un mensaje de chat a un agente (de tipo "dispara y olvida"; combínalo con wait_for_reply)
upload_file_to_agent	Sube un archivo (≤10 MiB, base64) y lo otorga a un agente, en una sola llamada
create_integration_connection	Conecta una integración pegando una clave/token de API
grant_integration_to_agent	Otorga a un agente acceso a una conexión y qué acciones
revoke_integration_grant	Revoca el acceso de un agente a una integración

Un endpoint público sin autenticación en https://api.atako.ai/mcp/public también expone 3 herramientas de marketing sin necesidad de clave API: get_pricing, list_use_cases y list_integration_pages; útiles para un asistente que investiga Atako en sí en lugar de actuar sobre tu cuenta.

La programación y la delegación las crean los agentes

No existe una herramienta create_cron_job ni create_sub_agent a propósito: un agente programa sus propias tareas recurrentes y crea sus propios subagentes mientras trabaja, en respuesta a que se le pida en una conversación normal, no mediante una API de creación separada. Dile al agente lo que quieres ("cada lunes a las 9 a. m., revisa X y envíame un resumen") y luego usa list_cron_jobs para confirmar lo que configuró e inspeccionar su historial de ejecución.

Dos cosas aún requieren un navegador

• Integraciones OAuth: get_connect_url te da la URL de autorización, pero completar una pantalla de consentimiento OAuth requiere que estés en un navegador real. Para un proveedor que solo necesita una clave/token de API pegado, create_integration_connection funciona sin ningún paso de navegador.
• Cambios de facturación y suscripción: no existe ninguna herramienta MCP para esto. Ve a app.atako.ai → Configuración → Facturación.

Recursos y avisos

• Recursos: atako://agents/{id} (misma forma que get_agent), atako://agents/{id}/files (misma forma que list_agent_files) y atako://docs/quickstart (la guía de inicio rápido de este producto, para un cliente que quiera familiarizarse con qué es Atako antes de llamar a cualquier herramienta).
• Avisos: diagnose_agent_issue (reúne el estado, la actividad y los mensajes recientes de un agente para ayudar a descubrir por qué parece atascado), weekly_credits_report (un resumen rápido de créditos/suscripción/lista de agentes), create_support_agent_from_brief (convierte una descripción libre en una llamada estructurada a create_agent) y connect_integration_wizard (recorre la conexión de un proveedor de principio a fin, eligiendo la herramienta adecuada según cómo se autentique).

Qué sigue

OAuth 2.1 con registro dinámico de clientes (una experiencia de "conectar" con un clic desde los conectores de claude.ai/ChatGPT en lugar de pegar una clave API) está planificado para una futura versión, junto con un modelo de alcance granular más limitado que "esta clave puede hacer todo lo que su propietario puede".