ダッシュボードでできることはすべて、REST 管理 API としても、AI エージェントのための MCP サーバーとしても、IaC のための Terraform プロバイダーとしても使えます。それらすべての下にあるアクセストークンが、誰が、あるいは何が、操作してよいかを決めます。
プラットフォームをコード、エージェント、IaC から動かす三つの方法。三つとも同じ操作を支えます。二級市民の面は、ひとつもありません。
公開された OpenAPI 3.1 仕様。あなたが使うどの言語でも型付きクライアントを生成でき、curl で直接呼ぶこともできます。ダッシュボードのどの操作にも、対応するエンドポイントがあります。私的な SDK 契約の陰に隠れるものは、何もありません。
どこに収まるか
自社向けの社内ツール、自動プロビジョニングのスクリプト、サーバー側の自動化など、コードが正しい操り手で、型付きクライアントが欲しいあらゆる場面。
curl -X POST https://caputchin.com/api/v1/management/sites \
-H "Authorization: Bearer cpt_pat_..." \
-H "Content-Type: application/json" \
-d '{
"name": "marketing",
"troop_id": "trp_abc"
}'Terraform Registry に公開された Terraform プロバイダー。Caputchin の構成をコードとして定義し、変更をプルリクエストでレビューし、既存の CI/CD パイプライン経由で適用する。あなたのほかのインフラを守る、インフラ。
どこに収まるか
IaC で動くチーム。すべてのサイトキー、すべてのチーム、すべてのトークンがバージョン管理下にある、再現可能な環境。
resource "caputchin_site_key" "marketing" {
name = "marketing"
troop_id = caputchin_troop.main.id
}あらゆる管理操作をツールとして公開する Model Context Protocol サーバー。私たちのホスト済みサーバーを使うか、npm パッケージを入れて自分のものを動かす。AI エージェントが、人がダッシュボードを操作するのと同じやり方で、あなたの設定を動かします。
どこに収まるか
エージェント型のワークフロー、インフラを管理する AI アシスタント、プロンプトで動く設定。クリックでの操作は、あなたのエージェントに任せましょう。
// AI agent's tool call after the prompt:
// "Create a marketing site under troop A"
caputchin_create_site({
name: "marketing",
troop_id: "trp_abc",
});プログラム的なものすべてを動かす認証情報。アカウント全体のためのマスタートークン一つ、範囲を絞ったものすべてのためのチームごとのトークン。
どのチームのどの操作にも作用します。スタート、ソロの自動化、あるいは一人アカウントの IaC パイプラインのための、既定キー。
各トークンは一つのチームに結びつきます。単一の環境に結びついた CI パイプライン、単一チームの面に結びついた AI エージェント。漏れは、そのチームの中に封じ込められます。