開発者向け

Atakoで構築する

独自のツールやAIエージェントをAtakoプラットフォームに接続するための、REST API、MCPサーバー、機械可読ファイル。

APIキーを取得

APIキー(aik_ プレフィックス)は所有者のアカウントへの完全なプログラムアクセスを付与します。発行できるのは会社の管理者のみです。

  1. 1app.atako.ai にサインインします
  2. 2「設定」を開き、「APIキー」タブを選択します
  3. 3「キーを作成」をクリックし、名前を付けます
  4. 4一度だけ表示される aik_… キーをコピーしてください。以降は二度と表示されません

キーの作成・失効を行えるのは会社の管理者のみです。

REST API

すべてのAPIルートは、ユーザーセッショントークンと同様に、Authorizationヘッダーで aik_ キーを受け付けます。

ベースURL

https://api.atako.ai

認証

すべてのリクエストで Authorization: Bearer aik_your_key を指定します。

サンプル

エージェント一覧を取得

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

エージェントを作成

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

エージェントにメッセージを送信

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

Atako MCPサーバー

Claude Code、Claude Desktop、CursorまたはChatGPTがAtakoアカウントのエージェント、アクティビティ、請求情報を直接読み取れるようにするModel Context Protocolサーバーです。

エンドポイント

https://api.atako.ai/mcp

インストール

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(開発者モード)

ChatGPTの開発者設定で、このURLと、APIキーを含むAuthorization Bearerヘッダーを指定してカスタムMCPコネクタを追加します。

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

公開エンドポイント

/mcp/public は認証不要で3つのマーケティングツール(料金、ユースケース、連携カタログ)を公開します。

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

get_pricing, list_use_cases, list_integration_pages

ドメイン別に分類された30の読み取り・書き込みツール

エージェント

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

メッセージとアクティビティ

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

ファイル

list_agent_files, upload_file_to_agent

連携機能

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

請求とプラットフォーム

get_credits, get_subscription, list_models, list_harnesses

サーバーはエージェントの操作も行えます。エージェントの作成、メッセージの送信と返信待ち、ファイルのアップロード、連携の接続・取り消しが可能です。

OAuth連携(Gmail、Slack、HubSpotなど)と決済には引き続きブラウザでの操作が必要で、エージェントがMCP経由で単独完了することはできません。

機械可読リソース

このサイトの公開コンテンツはすべて、エージェントやAIクローラー向けに設計された形式でも公開されています。

最初のAIエージェントを導入

無料でアカウントを作成し、コード不要で数分でエージェントを起動できます。