開発者向け API

マワリミチが公開する API は MCP (Model Context Protocol) gatewayに集約されています。Claude Desktop / Cursor 等の MCP クライアントから利用するのが標準ですが、 curl / cURL ライクな任意の HTTP クライアントからも同じ endpoint を叩けます。

提供範囲は公開投稿の検索 / 施設・展示・スタンプラリー・アンケート集計の取得 / 下書きの作成等で、本公開・配信・削除・契約変更・物理デバイス操作などの破壊的操作は公開していません。

• 認証方式は Bearer トークン（Authorization: Bearer mcp_...）。
• トークンの発行は マワリミチ Hub の接続管理ページから行います。発行直後に 1 度だけ平文を表示し、以降は再表示できません。
• 紛失時は該当接続を取消 → 新規作成してください。
• 権限は接続に紐付くロール (read / write / aggregate 等) で決まります。 呼び出しは組織契約 ∩ 接続のサービス許可 ∩ ロール権限の 3 段階で判定されます。
• 公開 tool（/public/mcp/v1/*）は認証不要ですが、IP 単位の rate limit が掛かります。

※ tool ごとの引数 schema は GET /mcp/v1/tools のレスポンスに含まれます。 実際に呼び出せる tool 一覧は接続作成後に Hub の接続詳細ページからも確認できます。

1. tool 一覧の取得

curl -s https://mcp.mawarimichi.app/mcp/v1/tools \
  -H "Authorization: Bearer mcp_xxxxxxxx_作成時に控えたトークンを貼る"

2. tool の呼び出し (公開投稿の検索)

curl -s -X POST https://mcp.mawarimichi.app/mcp/v1/tools/main.public.search \
  -H "Authorization: Bearer mcp_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "宝塚 イベント",
    "limit": 5
  }'

3. 匿名で公開 tool の一覧取得

curl -s https://mcp.mawarimichi.app/public/mcp/v1/tools

※ Claude Desktop / Cursor / Continue / Anthropic API / OpenAI Function Calling 用の設定ファイル・サンプルコードは、 Hub の接続詳細ページからワンクリックでダウンロードできます。詳細は /docs/mcp を参照。

• 認証付き /mcp/v1/tools/*: 60 req/min/接続。
• 匿名 /public/mcp/v1/*: IP 単位の rate limit（急増時は予告なく一時的に抑制する場合があります）。
• 超過時は HTTP 429 rate_limited を返します。
• 業務利用で常時上限が必要な場合は個別ご相談ください。

エラー時は HTTP status + JSON ボディ (error / message / 任意の追加フィールド) を返します。

レスポンス例 (402)

{
  "error": "insufficient_credit",
  "message": "クレジット残高が不足しています",
  "available": 1500,
  "required": 5000
}

主なエラーコード

※ 402 を受けたときは クレジット制度について を参照のうえ、Hub のクレジットページから残高を補充してください。

• 呼び出しは mcp_audit_logs に記録され、Hub の接続詳細ページから直近の履歴を確認できます。
• データは個人情報保護法・各種関連法令に準拠して取扱い、本接続のロール権限を超える範囲のデータは返しません。
• SLA / 大量呼出し / 業務契約は個別ご相談ください。
• API 仕様は予告なく変更する場合があります。重大な破壊的変更は事前にご連絡します。