Crevio

npx add-mcp 'https://mcp.crevio.co/mcp'

MCPサーバー

Claude、Cursor、またはMCP互換の任意のエージェントをCrevioアカウントに接続します。ask_crevioでCrevioエージェントに作業を委任し、実行を追跡・継続し、Crevio API全体と連携に対してスクリプトを実行できます。

Crevio MCPサーバーを使うと、MCP互換の任意のエージェントがCrevioに作業を委任できます。また、エージェント自身が制御を握りたい場合は、Crevio API全体と連携に対してスクリプトを実行できます。 1つのサーバー、2つのサーフェス:

• 委任 — ask_crevio はCrevioエージェントに平易な言葉でジョブを渡し(「jane@… からの最新の注文を返金して」「今週の投稿を書いてスケジュールして」)、結果を返します。長めのジョブはバックグラウンドで実行され、run として追跡し、会話を継続し、承認ゲートに回答し、トランスクリプトを読むことができます。
• スクリプト — list_integrations と list_integration_tools はスクリプトが呼び出せるものを示し、run_script はアカウントのCrevioコンピュータ上でJavaScriptを実行して、すべてのRESTエンドポイントと接続済みの連携に対して操作します。APIと同じ認可と検証が適用されます。

URL	https://mcp.crevio.co/mcp
トランスポート	Streamable HTTP(ステートレス — すべてのリクエストは自己完結)
認証	Authorization: Bearer <API token> — RESTで使用するのと同じAPIトークン — または、カスタムヘッダーしか設定できないクライアント向けの X-Api-Key: <API token>。OAuth 2.1もサポートされています。接続を参照してください。
ディスカバリ	https://mcp.crevio.co/mcp/server-card

[!NOTE]

Crevioのエージェントモデルが初めてですか?まずAI & エージェントの概要を読んで、MCP、タスク、イベントがどのように連携するかを確認してください。内部的には、委任されたジョブは1つのrunを持つタスクであるため、ここでのすべてはダッシュボードや /v1/tasks と /v1/task_runs からも確認できます。

セットアップ

1. APIトークンを作成する

Crevioで 設定 → 開発者 → APIトークン に移動して作成します。MCP接続は、その背後にあるトークンとまったく同じ権限を持ちます。つまり、アカウントができるすべてのことです。

2. クライアントを設定する

Claude Code

claude mcp add --transport http crevio https://mcp.crevio.co/mcp \
  --header "Authorization: Bearer $CREVIO_API_TOKEN"

Claude Desktop / Cursor / その他のクライアント — クライアントのMCP設定(claude_desktop_config.json、~/.cursor/mcp.json、…)に追加します:

{
  "mcpServers": {
    "crevio": {
      "url": "https://mcp.crevio.co/mcp",
      "headers": {
        "Authorization": "Bearer <CREVIO_API_TOKEN>"
      }
    }
  }
}

クライアント固有の手順、OAuth、生の curl の例は接続ページにあります。

3. whoamiで確認する

接続されたエージェントに whoami を呼び出すよう依頼します。トークンの背後にあるアカウントとユーザー、認証情報、プラン、クレジット残高、レート制限、待機制限、ツールの一覧を返します。引数も副作用もありません。whoami が動作すれば、他のすべても動作します。

{
  "object": "whoami",
  "account": { "id": "acct_7k2m…", "name": "Jane's Studio", "slug": "janes-studio" },
  "user": { "id": "user_9qx…", "email": "jane@example.com", "name": "Jane Doe" },
  "credential": { "type": "api_key", "id": "token_3fa…", "name": "Claude Desktop", "expires_at": null },
  "plan": "Pro",
  "credits": 1840,
  "rate_limit": { "limit": 600, "window_seconds": 60 },
  "limits": { "ask_timeout_default_seconds": 300, "ask_timeout_max_seconds": 300, "message_max_chars": 10000 },
  "tools": ["whoami", "ask_crevio", "start_chat", "wait_for_run", "get_run", "list_chats", "get_chat", "send_message", "resolve_approvals", "cancel_run", "list_runs", "list_messages", "list_integrations", "list_integration_tools", "run_script", "wait_for_script_run", "get_script_run", "cancel_script_run"]
}

推奨ワークフロー

単発ジョブ: ask_crevio

判断や執筆が必要な作業向けです。1回の呼び出しでrunを開始し、待機して、エージェントの最終返信を result に含むrunを返します。各ジョブは完全なエージェントrunであり、30秒から数分かかります。データを直接読み取ったり変更したりする場合は、スクリプトなら数秒で済みます。

{
  "name": "ask_crevio",
  "arguments": {
    "message": "Which three products made the most revenue this month, and how does that compare to last month?",
    "idempotency_key": "monthly-top-products-2026-08"
  }
}

{
  "object": "task_run",
  "id": "trun_8d1k…",
  "task_id": "task_2nq…",
  "task_name": "Which three products made the most revenue this month, and how does that…",
  "chat_id": "aichat_5pz…",
  "status": "completed",
  "summary": "Top three by revenue this month: …",
  "result": "Top three by revenue this month:\n1. Lightroom Presets Vol. 2 — $2,140 (+18% vs July)\n2. …",
  "error_message": null,
  "pending_approval_ids": [],
  "credits_consumed": 4,
  "started_at": "2026-08-20T09:14:02Z",
  "completed_at": "2026-08-20T09:14:31Z",
  "created_at": "2026-08-20T09:14:01Z"
}

• 待機時間は、クライアントがストリーミング返信を受け入れる場合(MCPクライアントがデフォルトで送信する Accept: text/event-stream)、デフォルトかつ上限が300秒で、それ以外の場合は90秒です。ストリーミング返信は待機中に10秒ごとに進捗通知を送信します。これを受信するには、_meta に progressToken を渡します。待機時間を短くするには timeout_seconds を渡します。
• 待機終了時にrunがまだ実行中の場合、返信はエラーではありません。wait_timed_out: true を持つrunです。その id を指定して wait_for_run を呼び出して待機を続けてください。ask_crevio を再度呼び出さないでください。ジョブが2回開始されてしまいます。何も失われません。runはCrevio側で継続します。
• idempotency_key はリトライを安全にします。同じキーを指定すると、別のrunを開始(および課金)する代わりに、最初の呼び出しで開始されたrunを返します。常に1つ渡してください。
• speed: "faster" はエージェントの思考を減らします。深さよりも素早い回答が重要な単純なジョブ向けです。デフォルトは smarter です。
• response_format は、プログラムが散文ではなくオブジェクトを必要とする場合にJSON Schema(またはOpenAIの {type: "json_schema", json_schema: {schema}})を受け取ります。エージェントにはスキーマが伝えられ、確定したrunは検証済みの解析値を json に、失敗した場合はその理由を json_error に含みます。start_chat と send_message も同様に受け取ります。
• run中にエージェントが配信したファイルは artifacts で返されます。アーティファクトの id を get_file_download_url でダウンロードリンクと交換できます。
• approval_mode はデフォルトで autonomous です。supervised を指定すると、runは各ゲート付き書き込みの前に needs_input で一時停止し、pending_approval_ids に回答するまで待機します(承認するものが何もないrunは提案とともに終了します。それに基づいて実行するには send_message で返信してください)。read_only は書き込みを禁止します。

長時間実行ジョブ: start_chat → wait_for_run → send_message

ブロックされたくないもの — サイト構築、リサーチタスク、一括移行など:

1. start_chat は作業をキューに入れ、すぐにrunを返します。
2. wait_for_run(上限あり)または get_run(即時)を、status が completed、failed、または needs_input になるまで繰り返します。
3. send_message は会話を継続します。追加の指示、修正、エージェントが尋ねた質問への回答などです。エージェントはコンテキストを保持します。終了したrunでは同じ会話内で新しいrunが開始され、needs_input のrunでは再開されます。同じ呼び出しで返信を待つには timeout_seconds を、リトライされた呼び出しがメッセージを2回送信する代わりに最初の呼び出しで開始されたrun(reused: true)を返すようにするには idempotency_key を渡します。
4. resolve_approvals は、runが連携アクション(pending_approval_ids を伴う needs_input)で一時停止している場合に使用します。保留中のすべてのIDを一度に承認または拒否すると、runが再開されます。
5. cancel_run は、保留中、実行中、または待機中のrunを停止します。

チャットは会話であり、runはその中の1回分の作業です。list_runs はアカウント上のすべてのrunを表示し(1つの会話のrunだけを表示するには chat_id を渡します)、委任されたジョブとスケジュールされたタスクの両方が含まれます。一方、list_chats と get_chat は会話自体を閲覧し、list_messages は最終返信だけでなくチャットの完全なトランスクリプトを読み取ります。

スクリプト: run_script

接続されたエージェントが委任ではなくCrevio自体を操作したい場合、または正確なデータを返す必要がある場合は、スクリプトを書きます。run_script はアカウントのCrevioコンピュータ上でbunを使ってJavaScriptを実行し、エージェントのターンは発生しません。スクリプトはCrevio APIとアカウントが接続しているすべての連携を呼び出し、好きなだけ呼び出しを連鎖させ、データを返す前に変換できます。

ディスカバリ

list_integrations はスクリプトが呼び出せるすべての名前空間を列挙します: crevioApi(Crevio API全体、操作ごとに1つの関数)、platform(Crevio独自のツール)、および接続済みの連携ごとに1つ(pdGmail、mcpLinear、…)。list_integration_tools は1つの名前空間の関数を一覧表示し、それぞれのパラメータをTypeScript型として、読み取り専用かどうか、承認が必要かどうか、および記入後に run_script が受け入れるスニペットを示します。crevioApi には数百の操作があるため、search で絞り込みます:

{ "namespace": "crevioApi", "search": "price variant create" }

実行

tools.<namespace>.<function>(args) は呼び出しを行います。トップレベルの await が機能し、すべての呼び出しは結果を返し、失敗時にはスローします。スクリプトの最後の式がその結果です。

const product = await tools.crevioApi.createProduct({ body: { name: "My Course", slug: "my-course" } });
await tools.crevioApi.createPriceVariant({
  body: { product: product.id, name: "Standard", amount_type: "fixed", amount: 4900, currency: "usd", billing_type: "one_time" },
});
await tools.crevioApi.updateProduct({ id_or_slug: product.id, body: { status: "active" } });
product.id

読み取りはパラメータを直接受け取ります(listOrders({ status: "succeeded" }))。書き込みはリクエストボディを body の下に渡し、パスパラメータをその横に置きます。

値は args(最大16個の文字列)で渡します。スクリプトはグローバル args からそれらを読み取ります。グローバル outputDir で指定されたディレクトリに書き込まれたファイルは、runの artifacts として返されます:

const { data } = await tools.crevioApi.listOrders({ status: "succeeded", limit: Number(args[0]) });
await Bun.write(`${outputDir}/orders.csv`, data.map((o) => o.id).join("\n"));
data.length

runはスクリプトrun(srun_…)を返します: その status(queued → in_progress → completed、failed、cancelled または timed_out)、result、スクリプトが output に出力した内容、その error、および calls — 実行したすべてのツール呼び出しとそのHTTPステータス。これにより、エラーをキャッチしたスクリプトでもどの呼び出しが失敗したかがわかります。run_script は ask_crevio が許す限り待機します(ストリーミング返信では300秒、それ以外では90秒。待機時間を短くするには wait_seconds を渡します)。それより長くかかるrunは wait_timed_out: true とそのIDを伴って返ります。これはエラーではありません。wait_for_script_run で待機を続けてください。同じ idempotency_key を渡さない限り、run_script を再度呼び出すとスクリプトが2回実行されます。

crevioApi の呼び出しは api.crevio.co と同じコントローラを経由するため、APIの規約がそのまま適用されます: 関連付けはプレフィックス付きIDを持つベア名(product_id ではなく product: "prod_abc")、金額はセント単位、リストエンドポイントは {object: "list", data: [...]} を返し、商品は active になる前に価格バリアントが必要です。コースやその他のコンテンツは商品ではなくエクスペリエンス(listExperiences)です。

制限:

• 対象者: アカウント管理者のみ。スクリプトはあなたとして(個人の連携を含む)実行され、チーム全体が共有するコンピュータ上で動作します。
• タイムアウト: timeout_seconds は1から600(デフォルト300)。コンピュータが最初に起動する必要がある場合があり、最大約20秒追加されることがあります。
• 同時実行: ユーザーあたり最大4run、アカウントあたり最大8runが実行中となります。
• 承認: スクリプトは停止して承認を求めることはできません。承認が必要な呼び出し(一覧の requires_approval)は approval_required で失敗します。そのアクションを 設定 → 連携 で自動実行に設定するか、代わりに ask_crevio でジョブを委任してください。
• キャンセル: queued のrunのみキャンセルできます。実行中のスクリプトは最後まで、またはタイムアウトまで実行されます。
• 出力ファイル: 1runあたり最大20個、各最大50 MB。それより大きいファイルは除外されます。

ツールの完全リファレンス

ツール	目的	引数
whoami	アカウント、ユーザー、認証情報、プラン、クレジット、制限、ツールを特定する	—
ask_crevio	ジョブを委任し、結果を待つ	message（必須）、timeout_seconds、approval_mode、speed、response_format、idempotency_key
start_chat	待たずにジョブを委任する	message（必須）、approval_mode、speed、response_format、idempotency_key
wait_for_run	実行が完了するまで（上限付きで）待つ	run_id（必須）、timeout_seconds
get_run	実行のステータス、サマリー、保留中の承認、最終応答を取得する	run_id（必須）
list_chats	アカウントのチャットを新しい順に一覧表示する	search、limit、starting_after、ending_before
get_chat	チャットのタイトル、種類、最新の実行を取得する	chat_id（必須）
send_message	チャットを続行する。任意で応答を待つ	chat_id、message（必須）、timeout_seconds、response_format、idempotency_key
resolve_approvals	実行が停止している統合アクションを承認/拒否する	run_id、approvals: [{id, approved, reason}]（必須）
cancel_run	保留中、実行中、または待機中の実行を停止する	run_id（必須）
list_runs	アカウントの実行を新しい順に一覧表示する	status、task_id、chat_id、limit、starting_after、ending_before
list_messages	チャットのメッセージを古い順に読む	chat_id（必須）、limit、ending_before
list_integrations	スクリプトが呼び出せるすべての名前空間を列挙する	—
list_integration_tools	名前空間の関数をパラメータとスニペット付きで一覧表示する	namespace（必須）、search、limit、offset
run_script	アカウントのコンピュータで JavaScript を実行し、完了を待つ	code（必須）、args、timeout_seconds、wait_seconds、idempotency_key
wait_for_script_run	スクリプト実行が終了するまで（上限付きで）待つ	run_id（必須）、wait_seconds
get_script_run	スクリプト実行のステータスと結果を読む	run_id（必須）
cancel_script_run	まだ開始されていないスクリプト実行をキャンセルする	run_id（必須）
get_file_download_url	アーティファクト ID（art_…）を 15 分間有効なダウンロードリンクと交換する	file_id（必須）
list_audit_events	アカウントの監査イベントを新しい順に一覧表示する。Enterprise プラン限定。audit:read スコープが必要で、認証情報が個人として動作する場合は管理者も必要	action、actor_type、entity_type、entity_id、after、limit、starting_after、ending_before

接続がどのツールを認識するかは、その認証情報によって決まります:

API キーと OAuth トークンは同じスコープを共有し、接続は認証情報のスコープが許可するツールを認識します:

• 読み取り系ツールには read、それ以外には write。ただし、そのツールが以下のいずれかのスコープを必要とする場合を除きます。
• ask_crevio、start_chat、send_message、cancel_run には agent:run、また resolve_approvals には write も必要です。write がない場合、委任された作業は読み取り専用で実行されます。
• run_script、wait_for_script_run、get_script_run、cancel_script_run には scripts:run が必要です。チームキーはこれらを決して認識せず、write がない場合、スクリプトは何も変更できません。
• get_file_download_url には files:read、list_audit_events には audit:read が必要です。
• whoami は何も必要としません。

read_only が付与された OAuth トークン（クライアントがスコープを要求しない場合のデフォルト）は read を保持します。read_write が付与されたトークンはすべてのスコープを保持し、すべてのツールを認識します。スコープが存在する前に作成された API キーも同様です。

トークンが使用できないツールは tools/list に表示されず、呼び出すと「Tool not found」と応答します。スコープに加えて、エージェントが触れてもよいデータを持つアカウントのトークンを渡し、委任されたジョブでは approval_mode を選択することで、エージェントができることを制限できます。

実行オブジェクト

委任ツールは実行（trun_…）を返します。これは GET /v1/task_runs/:id と同じオブジェクトに result と chat_id を加えたものです:

フィールド	意味
status	pending → running → completed / failed、またはエージェントがあなたの応答を待っている場合は needs_input
result	エージェントの最終応答。最大 24,000 文字（実行が完了すると存在）
json、json_error	response_format を指定した場合: 解析・検証済みの応答、またはスキーマに対して有効な JSON でなかった理由
artifacts	実行が配信したファイル。それぞれ {id, filename, content_type, size}。get_file_download_url でダウンロード
summary	応答の最初の 500 文字 — ダッシュボードと Webhook が表示する内容
pending_approval_ids	needs_input の場合: 実行をブロックしている統合の承認。resolve_approvals 用
error_message	failed の実行が失敗した理由（cancel_run の後の "Cancelled by the caller"）
wait_timed_out、next_step	実行が完了する前に待機が終了した場合に存在 — まだ実行中であり、next_step が追跡方法を示す
credits_consumed	実行のコスト（AI クレジット）
task_id、chat_id	基になる Task と会話。REST API とダッシュボード用

実行はまた、task_run.completed、task_run.failed、task_run.needs_input の Webhook を発火し、GET /v1/task_runs/:id/stream で SSE 経由でストリーミングできます。

MCP Tasks と elicitation

これらは MCP クライアントのプロトコル機能であり、Crevio 独自の Tasks とは別のものです。これらを使用すると、クライアントは長時間のジョブを追跡し、wait_for_run や resolve_approvals を呼び出す代わりに承認に自ら応答します。どちらもクライアントが選択する 2026-07-28 プロトコルを必要とします。これらがない場合、すべてのツールは上記のとおりに動作します。

非同期ツール呼び出し

サーバーは MCP Tasks 拡張（io.modelcontextprotocol/tasks）を実装しており、/mcp と /chatgpt の両方で server/discover にアドバタイズされます。リクエストが _meta["io.modelcontextprotocol/clientCapabilities"].extensions でこれを宣言すると、これらのツールは最大 5 秒待機し、リクエストを開いたままにせずにタスクハンドル（"resultType": "task"）を返します: ask_crevio、wait_for_run、timeout_seconds を伴う send_message、run_script、wait_for_script_run。この 5 秒以内に完了した実行はその場で応答されます。

• tasks/get はタスクの status を返します。working は実行がまだ進行中であることを意味します。completed になると、result はタスクなしでツールが返したはずの内容を正確に保持します。pollIntervalMs でポーリングしてください: エージェント実行は 3 秒、スクリプトは 1 秒です。
• tasks/update はタスクの inputRequests に応答します（以下を参照）。
• tasks/cancel は cancel_run や cancel_script_run と同様に実行を停止します。

タスクは実行そのものであるため、実行と同じ期間存続します（ttlMs は null）。failed で終了した実行もタスクを完了します: result 内の status と error_message を読んでください。タスク自体の failed ステータスはプロトコルエラー用に保持されます。タスク ID は推測不可能であり、実行を開始したアカウントとユーザーのみが読むことができます。不明または外部の ID は -32602 と応答し、拡張を宣言していないリクエストは -32021 と応答します。

承認と質問

クライアントがフォーム elicitation（_meta["io.modelcontextprotocol/clientCapabilities"].elicitation）を宣言すると、needs_input で一時停止した実行はユーザーに直接問い合わせます:

実行が待っているもの	クライアントへの問い合わせ	承認	拒否または閉じる
統合アクションの承認	アクションごとに 1 つのフォーム。承認 ID（apr_…）をキーとし、送信される内容を記述	承認する	拒否する
エージェントの質問への回答	reply フィールドを持つ 1 つのフォーム	返信を送信し、実行が続行する	実行を完了として閉じる

閉じられた承認は拒否であるため、明示的な「はい」なしには何も実行されません。フォームには任意の順序で、また一度にいくつか回答できます。すべてに回答があると実行が再開され、エージェントはすべての決定をまとめて受け取ります。

• タスクありの場合: タスクはフォームを inputRequests に含めて input_required に移行します。tasks/update で回答してください。
• タスクなしの場合: ツールはフォームと requestState を伴う "resultType": "input_required" を返します。同じ引数に inputResponses とその正確な requestState を加えて、同じツールを再度呼び出してください。状態は封印され、ツールとその引数にバインドされ、1 時間後に期限切れになります。
• フォーム elicitation なしの場合: 何も変わりません。実行は resolve_approvals 用の pending_approval_ids を伴い needs_input で返ります。完了したタスクとしても同様です。

イベント

サーバーはドラフトの MCP Events 拡張（io.modelcontextprotocol/events）を実装しているため、クライアントは order.paid や email_message.received などアカウント内で起こることを購読し、ポーリングせずに反応できます。これは /mcp と /chatgpt の両方で server/discover にアドバタイズされます。

イベントの種類は Webhook と同じで、ペイロードも同じです: data.object はその API エンドポイントが返すとおりのリソースです。events/list はすべての種類をその payloadSchema とともに一覧表示します。

購読

{
  "jsonrpc": "2.0", "id": 2, "method": "events/subscribe",
  "params": {
    "name": "order.paid",
    "arguments": {},
    "delivery": { "mode": "webhook", "url": "https://hooks.example.com/crevio", "secret": "whsec_<base64 of 24–64 random bytes>" },
    "cursor": null,
    "ttlMs": 86400000
  }
}

応答には購読の id（mcpsub_…、同じ認証情報・URL・イベント・引数に対して安定）と refreshBefore が含まれます。維持するには refreshBefore の前に同じ値で events/subscribe を再度呼び出してください。name、arguments、delivery.url を伴う events/unsubscribe は即座に終了します。

• 検証。 URL への最初の配信の前に、Crevio は {"type":"verification","challenge":"<nonce>"} を POST します。5 秒以内に 2xx と {"challenge":"<nonce>"} で応答してください。各認証情報は各 URL を一度検証します。
• 有効期間。 ttlMs がない場合、購読は 1 日間続きます。提案された ttlMs は 1 分から 1 日の間で保持されます。"ttlMs": null は期限なしを要求し、Crevio はそれを許可します。
• シークレットのローテーション。 更新時に新しい delivery.secret を送信してください。10 分間、配信は両方のシークレットからの署名を伴います。
• 制限。 アカウントあたり 100 件の有効な購読。購読は読み取りのみであるため、read_only トークンでも実行できます。

配信

各イベントは {"eventId", "name", "timestamp", "data"} の POST であり、Standard Webhooks に従ってあなたのシークレット（webhook-id、webhook-timestamp、webhook-signature）で署名され、X-MCP-Subscription-Id を含みます。本文を信頼する前に署名を検証し、eventId で重複排除してください。

エンドポイントの動作	結果
2xx と応答	配信済み
410 または 413 と応答	再試行せずに破棄
失敗またはタイムアウト（5 秒）	約 12 分間にわたって最大 4 回再試行し、その後破棄
1 時間失敗し続ける	次回の更新で再有効化されるまで配信を停止
期限なしの購読で 3 日間失敗し続ける	Crevio は {"type":"terminated",…} を POST し、購読を削除

認証情報がアカウントへのアクセスを失った場合（キーの削除または期限切れ、OAuth アクセスの取り消し、アカウントからのユーザー削除）、次のイベントでエラー -32024 を含む terminated エンベロープで購読が終了します。

できないこと

• 現時点では設計上、Webhook 配信のみです。 events/poll と events/stream は -32026 を返します。POST を受信できない場合は、webhooks API または list_runs と REST エンドポイントを使用してください。
• リプレイなし。 cursor は常に null です。サブスクリプションが失効している間に発生したイベントは後から配信されません。ギャップの後は、ツールを通じて現在の状態を読み取ってください。
• フィルターなし。 イベントタイプは arguments を受け取りません。サブスクリプションは、アカウント内のそのタイプのすべてのイベントを受信します。

エラーは拡張機能のコードを使用します: -32602 は無効なパラメーター (不正な URL、シークレット、または引数)、-32023 は不明なイベントまたはサブスクリプション、-32024 は認証済みプリンシパルがないかアクセスが失われた、-32025 はサブスクリプション上限、-32026 は配信モードが提供されていない、-32027 はコールバックが検証に失敗したことを示し、data.reason は connection_refused、timeout、tls_error、http_4xx、http_5xx、または challenge_failed のいずれかです。

エラー

認証の失敗はリクエスト自体に対する HTTP 401/403 です (WWW-Authenticate は OAuth メタデータを指します)。ツールの失敗は、isError: true と JSON ボディを含むツール結果として返されます:

{ "error": "run_busy", "message": "Run trun_8d1k… is still in progress; wait for it to settle before sending more.", "http_status": 409 }

error	意味	対処方法
run_busy	この会話内の実行がまだ進行中です	完了を待ってから send_message
account_at_capacity	アカウントで既に 5 件の実行が進行中です (http_status: 429)	retry_after_seconds 後に再試行
idempotency_error	idempotency_key が異なるメッセージで再利用されました	新しいメッセージには新しいキーを渡してください
run_not_active	既に終了した実行に対する cancel_run	何も不要 — その result を読み取ってください
run_not_resumable	実行に続行する会話がありません	ask_crevio で新しいジョブを開始してください
approvals_pending	承認によってブロックされている実行に対する send_message	先に resolve_approvals
stale_resolution	送信した承認が保留中のセットと一致しません	get_run してから、すべての pending_approval_ids エントリを再送信してください
insufficient_credits	アカウントに AI クレジットが残っていません	Crevio でクレジットを追加してください
resource_missing	このアカウントにその ID の実行/タスクはありません	ID を確認してください — 実行はアカウント単位です
validation_failed	不正な引数 (例: 不明な approval_mode)	引数を修正してください
rate_limit_exceeded	オーナーあたり毎分 600 リクエスト (REST API と共有) — または実行中のスクリプト実行が多すぎます	X-RateLimit-Reset までバックオフするか (レート制限)、スクリプト実行の完了を待ってください
forbidden	アカウント管理者ではないユーザーによる run_script	管理者に依頼するか、ask_crevio で委任してください
run_not_cancellable	既に開始された実行に対する cancel_script_run	wait_for_script_run で完了を待ってください

例外をスローするスクリプトも、status: "failed"、その error、および生成した calls を含むスクリプト実行として返されます — run_script 自体がエラーになるのは、実行を開始できなかった場合または待機が終了した場合のみです。

セキュリティ

すべてのツールはアカウントのテナント境界内で実行されます。委任されたジョブは、アカウントが既に持っている権限で Crevio エージェントを実行します。run_script は呼び出し元の管理者としてアカウントの Crevio コンピューター上で実行されます。その tools 呼び出しは、エージェントが従うのと同じ承認設定と、api.crevio.co と同じ API コントローラーを経由するため、認可、検証、エラーメッセージは直接の API 呼び出しと同一です。トークンはアカウントと同じ強力さを持ちます: 信頼できるエージェントのみを接続し、接続を即座に切断するには 設定 → 開発者 からトークンを取り消してください。

次のステップ

接続

クライアントごとのセットアップ、OAuth、curl の例。

タスク (AI ワークフォース)

すべての委任ジョブの基盤となる Task / Task Run モデル — および定期的な作業をスケジュールする方法。

AI とエージェントの概要

MCP、タスク、イベントが Crevio のエージェントモデルをどのように形成するか。

API の規約

crevioApi が REST と共有する形状、プレフィックス、注意点。

このドキュメントは、開発者向けドキュメントプラットフォームである Mintlify 上で構築およびホストされています。