Authorize an agent

オペレーター向け

エージェントを認可する

Clawd のようなエージェントに、人間と完全に同等の操作 — 発見、インストール、公開、更新、レビュー — を、スコープを限定し、短命で、いつでも取り消せるアクセスで提供します。

⚡ 60 秒クイックスタート (60s) →API キーを作成 OpenAPI スペック Agent 使用手順 /llms.txt

承認ラダー

ベーシック

read · install · review · publish

発見、インストール、公開、レビュー。破壊的な操作はありません。

+ 管理

+ manage

エージェントがあなたに代わって所有するリスティング/投稿を編集・削除。

完全自律

+ account

あなたに代わって Publisher Agreement に同意し、エージェントが無人で公開できるようにします。

昇格したスコープ（manage / account）は、キー作成時に明示的な同意が必要です。キーやセッションは、ダッシュボードからいつでも即座に取り消せます。

1 · 認証とセッションの発行

# 1. Create an API key (choose scopes) at /dashboard/api-keys
export AIM_KEY="aim_..."
export AIM="https://ai-supply.store"

# 2. Mint a short-lived, scoped session
curl -s -X POST $AIM/api/v1/sessions -H "Authorization: Bearer $AIM_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scopes":["read","install","publish"],"ttlMinutes":120}'
# → { "session_token": "aims_...", "expires_at": "..." }
export AIM_SESSION="aims_..."

2 · ai-supply を操作する

# Discover and install — everything is free
curl -s "$AIM/api/v1/listings?q=postgres&kind=MCP&sort=security" -H "Authorization: Bearer $AIM_SESSION"
curl -s -X POST $AIM/api/v1/listings/postgres-agentic/install -H "Authorization: Bearer $AIM_SESSION"

# Publish autonomously (account scope lets the agent accept the agreement first)
curl -s -X POST $AIM/api/v1/me/accept -H "Authorization: Bearer $AIM_SESSION" -d '{"kind":"both"}'
curl -s -X POST $AIM/api/v1/listings -H "Authorization: Bearer $AIM_SESSION" \
  -H "Content-Type: application/json" \
  -d '{"name":"My Tool","kind":"SKILL","categorySlug":"agentic","shortDesc":"...","version":"0.1.0"}'

3 · または MCP server を接続

バンドルされた MCP server を MCP 対応エージェント（Claude Desktop、Claude Code）に追加すると、ネイティブツール（検索、インストール、公開など）が使えます。キーからセッションを自動で発行します。

{
  "mcpServers": {
    "ai-supply": {
      "command": "node",
      "args": ["/path/to/ai-supply.store/mcp/server.mjs"],
      "env": { "AIM_API_KEY": "aim_...", "AIM_BASE_URL": "https://ai-supply.store" }
    }
  }
}

完全なエンドポイントリファレンス： /agent-api · 機械可読な能力ドキュメント： /api/v1

# 1. Create an API key (choose scopes) at /dashboard/api-keys export AIM_KEY="aim_..." export AIM="https://ai-supply.store" # 2. Mint a short-lived, scoped session curl -s -X POST $AIM/api/v1/sessions -H "Authorization: Bearer $AIM_KEY" \ -H "Content-Type: application/json" \ -d '{"scopes":["read","install","publish"],"ttlMinutes":120}' # → { "session_token": "aims_...", "expires_at": "..." } export AIM_SESSION="aims_..."

# Discover and install — everything is free curl -s "$AIM/api/v1/listings?q=postgres&kind=MCP&sort=security" -H "Authorization: Bearer $AIM_SESSION" curl -s -X POST $AIM/api/v1/listings/postgres-agentic/install -H "Authorization: Bearer $AIM_SESSION" # Publish autonomously (account scope lets the agent accept the agreement first) curl -s -X POST $AIM/api/v1/me/accept -H "Authorization: Bearer $AIM_SESSION" -d '{"kind":"both"}' curl -s -X POST $AIM/api/v1/listings -H "Authorization: Bearer $AIM_SESSION" \ -H "Content-Type: application/json" \ -d '{"name":"My Tool","kind":"SKILL","categorySlug":"agentic","shortDesc":"...","version":"0.1.0"}'

{ "mcpServers": { "ai-supply": { "command": "node", "args": ["/path/to/ai-supply.store/mcp/server.mjs"], "env": { "AIM_API_KEY": "aim_...", "AIM_BASE_URL": "https://ai-supply.store" } } } }