Sviluppatori

Costruisci con Atako

Un'API REST, un server MCP e file leggibili dalle macchine per collegare i tuoi strumenti e i tuoi agenti IA alla piattaforma Atako.

Ottieni una chiave API

Le chiavi API (prefisso aik_) garantiscono accesso programmatico completo all'account del proprietario, riservato agli amministratori dell'azienda.

  1. 1Accedi su app.atako.ai
  2. 2Apri Impostazioni, poi la scheda Chiavi API
  3. 3Fai clic su Crea chiave e assegnale un nome
  4. 4Copia la chiave aik_… mostrata una sola volta: non sarà più visibile in seguito

Solo gli amministratori dell'azienda possono creare o revocare una chiave.

API REST

Ogni endpoint dell'API accetta una chiave aik_ nell'header Authorization, esattamente come un token di sessione utente.

URL di base

https://api.atako.ai

Autenticazione

Authorization: Bearer aik_tua_chiave su ogni richiesta.

Esempi

Elenca i tuoi agenti

curl https://api.atako.ai/agents \
  -H "Authorization: Bearer aik_..."

Crea un agente

curl https://api.atako.ai/agents \
  -H "Authorization: Bearer aik_..." \
  -H "Content-Type: application/json" \
  -d '{"name":"Support Agent","image":"aiygent-transp-1.png"}'

Invia un messaggio a un agente

curl https://api.atako.ai/agents/AGENT_ID/messages \
  -H "Authorization: Bearer aik_..." \
  -H "Content-Type: application/json" \
  -d '{"content":"Hello!"}'

Il server MCP di Atako

Un server Model Context Protocol che permette a Claude Code, Claude Desktop, Cursor o ChatGPT di leggere direttamente agenti, attività e fatturazione di un account Atako.

Endpoint

https://api.atako.ai/mcp

Installazione

Claude Code

claude mcp add --transport http atako https://api.atako.ai/mcp \
  --header "Authorization: Bearer aik_..."

Cursor

{
  "mcpServers": {
    "atako": {
      "url": "https://api.atako.ai/mcp",
      "headers": {
        "Authorization": "Bearer aik_..."
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "atako": {
      "url": "https://api.atako.ai/mcp",
      "headers": {
        "Authorization": "Bearer aik_..."
      }
    }
  }
}

ChatGPT (modalità sviluppatore)

Nelle impostazioni sviluppatore di ChatGPT, aggiungi un connettore MCP personalizzato con questo URL e un header Authorization Bearer contenente la tua chiave.

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

Endpoint pubblico

/mcp/public espone 3 strumenti di marketing (prezzi, casi d'uso, catalogo integrazioni) senza autenticazione.

https://api.atako.ai/mcp/public

get_pricing, list_use_cases, list_integration_pages

30 strumenti in lettura e scrittura, raggruppati per area

Agenti

list_agents, get_agent, whoami, create_agent, update_agent_name, end_agent, resume_agent, cancel_agent_provisioning, retry_agent_provisioning

Messaggi e attività

list_messages, send_message, wait_for_reply, list_activity, get_activity_state, list_interagent_messages, list_sub_agents, list_cron_jobs

File

list_agent_files, upload_file_to_agent

Integrazioni

list_integration_catalog, list_integration_connections, list_agent_integration_grants, create_integration_connection, get_connect_url, grant_integration_to_agent, revoke_integration_grant

Fatturazione e piattaforma

get_credits, get_subscription, list_models, list_harnesses

Il server può anche pilotare i tuoi agenti: creare un agente, inviargli un messaggio e attendere la risposta, caricargli un file, e connettere o revocare un'integrazione.

Le connessioni OAuth (Gmail, Slack, HubSpot…) e i pagamenti richiedono comunque un browser: un agente non può completarli da solo tramite MCP.

Risorse leggibili dalle macchine

Tutti i contenuti pubblici di questo sito sono pubblicati anche in formati pensati per agenti e crawler IA.

Distribuisci i tuoi primi agenti IA

Crea il tuo account gratuitamente e avvia un agente in pochi minuti, senza codice.