Macha
機能 Zendesk 向け Macha 継続的なエージェント評価 Chrome 拡張機能 Zendesk コパイロット ウィジェット Sidekick で構築 Claude Code と Codex で構築 ユースケース 連携 料金 ドキュメント API リファレンス 効果的なエージェントの構築
ログイン 無料トライアルを開始
~ macha · 開発者向け API

サポートエージェントを、 ターミナルから構築。

Macha をコーディングエージェントから直接操作。API キーを渡せば、コネクタ、ツール、トリガー付きの動作するエージェントを、コマンドラインを離れずに出荷できます。

無料トライアルを始める API ドキュメントを読む
対応: Claude Code Codex Cursor
claude、Macha エージェントを構築

Claude Code へようこそ

Opus 4.8 · ~/macha-agents

> Macha キーです: mka_live_••••

Shopify + Zendesk で WISMO エージェントを構築して。

● Macha API 仕様を読む

┗ llms-full.txt · OpenAPI 3.1

● GET /connectors

┗ shopify · zendesk · stripe

● POST /agents → @wismo

┗ { id: "agent_7Qh2…", tools: 3, is_active: true }

✓ @wismo を作成 · ダッシュボードでライブ

お好みの コーディングエージェントで。

API はシンプルな HTTP と AI 可読ドキュメント。どのエージェント型コーディングツールでも仕様を読み込んで構築できます。

Claude Code

llms-full.txt とキーを指定すれば、仕様を読み込んで構築します。

$ claude "read $MACHA/llms-full.txt"

Codex

llms-full.txt とキーを指定すれば、仕様を読み込んで構築します。

$ codex --doc $MACHA/openapi.json

Cursor

llms-full.txt とキーを指定すれば、仕様を読み込んで構築します。

@Docs → getmacha.com/llms-full.txt

すべて同じ理由で動作します: HTTP + llms.txt + OpenAPI。SDK ロックインなし、cURL や任意の HTTP クライアントから同じフローが使えます。

コーディングエージェントが Macha を操作するために必要なすべて。

クリーンな REST サーフェス、最小権限のキー、機械が読むために書かれたドキュメント。

本物の REST API

Bearer 認証、{ data, meta } エンベロープ、安定したエラーコード、冪等な書き込み、1,000/分 · 10,000/時のレート制限。

https://dashboard.getmacha.com/api/v1

スコープ付きキー

設定 → API Keys から mka_live_… キーを {resource}:{action} スコープ付きで発行。最小権限、組織スコープ、1 回だけ表示 (bcrypt ハッシュ)。

mka_live_•••• · agents:write

AI 可読ドキュメント

llms.txt + llms-full.txt を www.getmacha.com で公開、加えて全操作に x-required-scope を持つ OpenAPI 3.1 仕様。

/api/v1/openapi.json

キーから動くエージェントまで、 1 セッションで。

  • 1

    スコープ付きキーを発行

    設定 → API Keys から、必要なスコープだけを持つ mka_live_ キーを発行。1 回だけ表示されます。

  • 2

    コーディングエージェントにドキュメントを指定

    llms-full.txt と OpenAPI 仕様を Claude Code や Codex に渡し、MACHA_API_KEY を設定。

  • 3

    コネクタ一覧からツールを発見

    エージェントが GET /connectors を呼び、あなたの組織にある実際のツール名を取得、推測なし。

  • 4

    /agents で作成

    1 回の冪等な POST /agents が指示とツールを配線。レスポンスに新しいエージェント ID が返ります。

claude、WISMO エージェントを構築 
$ export MACHA_API_KEY=mka_live_••••
$ curl -s $MACHA/api/v1/connectors
  → shopify · zendesk · …
$ curl -s -X POST $MACHA/api/v1/agents -d '{
    "handle":"wismo", "tools":[
      "shopify_get_order",
      "shopify_search_orders",
      "zendesk_add_public_reply" ] }'
  { "data":{ "id":"agent_7Qh2…", "handle":"@wismo",
    "model":"claude-sonnet", "tools_count":3 } }
✓ created

作れるものと 作れないもの。

v1 サーフェスの正直な地図。設定とコンテンツはプログラム可能、ライブランタイム、課金、安全性重視の面は設計上ダッシュボード内に残ります。

エージェント

フル CRUD

作成・読取・更新・削除、指示と各エージェントが呼べるツール。

カスタムツール

フル CRUD

POST /custom_tools で自社の REST API をエージェントツールとして登録。

ソース

フル CRUD

エージェントの背後にある知識ソースをプログラムから管理。

会話

読み取り

会話履歴をカーソルページングでウェアハウスに取り込み。読み取り専用。

コネクタ

読み取り

組織に配線されたコネクタとツール名を一覧。

v1 ではトリガーは読み取り専用、ダッシュボードで Webhook とスケジュールトリガーを設定してから API で読み戻します。ライブチャットターン、課金、Studies、Sidekick は設計上ダッシュボード専用。

なぜ AI が 実際に運転できるのか。

  • ✓

    どこでも同じレスポンスエンベロープ。 全エンドポイントが { data, meta } を返し、request_id と next_cursor を含みます。形は 1 回覚えるだけ。

  • ✓

    安定した機械判定可能なエラーコード。 エラーは散文だけでなく安定した code を持ちます。

  • ✓

    スコープは発見可能。 403 と x-required-scope により、どのスコープを求めればよいかエージェントが把握できます。

  • ✓

    冪等リトライは重複しない。 書き込みは Idempotency-Key を 24 時間再生します。

どこでも同じエンベロープ

{ "data": { … },
  "meta": { "request_id":"req_a1b2c3",
          "next_cursor":"eyJpZ…" } }

モデルが分岐できるエラー

{ "error": {
    "code":"insufficient_scope",
    "message":"needs agents:write" } }

任せても安全にする ガードレール。

自律エージェントにキーを渡せるのは、影響範囲が小さく、可逆で、監査できる場合だけです。

安全に委任
  • ✓

    最小権限のスコープ付きキー — 付与したことしかできません。

  • ✓

    冪等な書き込み — Idempotency-Key によりリトライは重複しません。

  • ✓

    キー単位のレート制限 — 1,000/分 · 10,000/時、429 で Retry-After を返却。

  • ✓

    ソフト削除 — 削除は 30 日ゴミ箱に入り、ワンクリックで復元可能。

  • ✓

    監査ログ — すべての API 操作に「API キー <label> 経由で作成」のタグ。

  • ✓

    漏洩の自動失効 — mka_live_ プレフィックスは公開 GitHub でスキャンされ、自動失効。

1 エージェントの 先へ。

API になれば、あなたのワークフロー全般のツールが使えます。

Git のエージェント・アズ・コード

エージェント定義をリポジトリに置き、マージ時に CI から PATCH /agents を実行。プロンプト変更をコードとしてレビュー。

一括配線

製品ラインごとにサブエージェントをループ生成、クリック作業の何時間もがスクリプトに。

自社 API をツールに

内部の REST エンドポイントを POST /custom_tools で登録して、エージェントに社内システムを呼ばせる。

会話をウェアハウスへ

GET /conversations をカーソルでページングし、BigQuery や Snowflake に取り込み。

.github/workflows/agents.yml 
# main へのマージごとにエージェント設定を同期
$ curl -X PATCH $MACHA/api/v1/agents/$ID \
    -H "Idempotency-Key: $GITHUB_SHA" \
    --data @agents/wismo.json
✓ wismo 更新 · req_4f8a…

// コスト

API は無料。 API 経由のエージェント構築・管理はクレジット消費ゼロ、計測なし、トライアルを含む全アカウントで利用可能。クレジットは、構築したエージェントが実際に 動作 したとき (チケット処理やトリガー発火) にだけ消費されます。

あなたなら Macha API で何を作りますか?

API キーを取得 → # それから Claude Code、Codex、Cursor にキーを貼り付け

または API ドキュメント を読む。

よくある 質問。

API で何ができて何ができないか、どう保護されているか、どのコーディングエージェントで動くか。

はい、キーは付与したスコープだけを持ち、組織スコープです。発見用のエージェントには読み取り専用キーを渡し、実際に構築させたいときにだけ agents:write を予約します。削除はソフト (30 日ゴミ箱で復元)、冪等性で書き込み重複を防止、変更ごとに request_id とキーラベルで監査され、mka_live_ プレフィックスは GitHub と GitGuardian でスキャンされ、漏洩キーは自動失効します。
v1 では、トリガー、チャットボット、チーム、分析、組織は読み取り専用、ダッシュボードで Webhook とスケジュールトリガーを設定してから API で読み戻します。ライブチャットターン、課金、Studies、Sidekick は設計上ダッシュボード専用。API はエージェントの構築と管理用 (agents、custom tools、sources はフル CRUD) で、リアルタイム会話の提供用ではありません。
API 自体は無料です。キーを発行し、エージェント、コネクタ、ツール、ソースを構築・管理する使い方は クレジット消費ゼロ、通話単位の課金や API 計測はなく、トライアルを含む全アカウントで利用可能。API は管理レイヤーであり、実行レイヤーではないためです: ダッシュボード上のエージェントを設定するもので、実行はしません。クレジットはエージェントが実際に 動作 し、トリガー発火やチケット処理で実アクションを取ったときにだけ消費されます。この実行コストはクレジット制 (モデルごとの AI アクション単位) で、手動で構築したエージェントでも API で構築したエージェントでも同じです。
シェルコマンドが実行できて URL を読めるエージェントなら何でも。Claude Code、Codex、Cursor が特に相性がよく、llms-full.txt と OpenAPI 仕様を指定し、環境変数に MACHA_API_KEY を設定するだけで、コネクタを発見しエージェントを作成できます。Bearer トークン付きの素の REST API なので、任意のスクリプトやフレームワークからも同じフローが動きます。
各キーは {resource}:{action} スコープの集合に制限されます。例: agents:read、agents:write。OpenAPI 仕様のすべての操作は x-required-scope で必要スコープを宣言するため、呼び出し前にエージェントが要件を把握できます。スコープが足りない場合は 403 insufficient_scope を返し、必要なスコープを名指しします、エージェントはユーザーにキーの拡張を求められます。

キーをコーディングエージェントに渡し、 構築を始める。

無料トライアルを始める API ドキュメントを読む

500 の無料クレジット · 時間制限なし、クレジットカード不要