マワリミチ MCP ドキュメント

マワリミチ MCP とは

マワリミチ MCP は、Anthropic が提唱する Model Context Protocol のサーバ実装です。Claude Desktop や Cursor 等の MCP 対応クライアントから、マワリミチの公開投稿の検索 / 施設・展示・スタンプラリー・アンケート集計の取得 / 下書きの作成 等を、ロール権限の範囲内で呼び出せます。

アクセスはマワリミチ Hub で発行する Bearer トークン経由で、組織契約サービス・接続のサービス許可・ロール権限の 3 段階チェックを通過したものだけが実行されます。本公開・配信・削除・契約変更・物理デバイス操作などの 破壊的操作は MCP 経路からは公開していません。

対応クライアント

以下の 5 種類のクライアントから利用できます。Hub の 接続管理ページで各クライアント用の設定例・サンプルコードを自動生成できます。

認証

• 認証方式: Bearer トークン (Authorization: Bearer mcp_...)
• トークンの発行は マワリミチ Hub の接続管理ページから行います。発行直後に 1 度だけ平文を表示し、以降は表示できません (DB にはハッシュのみ保存)。
• 紛失時は該当接続を取消 + 新規作成してください。再表示はできません。
• 権限は接続に紐付くロールで決まります。ロール / 利用サービス許可は Hub から変更できます。

{
  "mcpServers": {
    "mawarimichi": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch", "https://mcp.mawarimichi.app/mcp/v1"],
      "env": {
        "MCP_AUTH_TOKEN": "mcp_xxxxxxxx_作成時に控えたトークンを貼る"
      }
    }
  }
}

提供しているコマンド (tool) 一覧

ロールに割り当てられた権限の範囲で、以下の tool（コマンド）を呼び出せます。name がAIに渡すコマンド名、入力 が主な引数です。実際に呼び出せる一覧は接続作成後に Hub の接続詳細ページからも確認できます。

※ いずれも閲覧・検索・集計・下書き作成・提案までです。投稿の本公開・配信・削除・契約変更・物理デバイス操作・個人情報を含む設問回答の取得 等は MCP 経路では公開していません（人が管理画面で操作）。

マワリミチ Connect の MCP

データ連携基盤「マワリミチ Connect」は、本体 MCP とは別の MCP サーバ (connect-mcp, stdio) として、 発行済みデータセットを NGSI 互換で読み出すツールを提供します（read-only）。

5 段階の操作レベル

tool の挙動を 5 段階で区分しています。read / draft / preview は提供範囲が広く、approve-apply / automatic-execution は提供範囲を絞っています。

制限・運用

• レート制限: 60 req/min/接続 を上限とします (急増時は予告なく一時的に抑制する場合があります)。
• 呼び出しは 組織契約 ∩ 接続のサービス許可 ∩ ロール権限 の 3 段階チェックを通過したものだけが実行されます。
• 呼び出しは mcp_audit_logs に記録され、Hub の接続詳細ページから直近 20 件を確認できます。
• データは個人情報保護法・各種関連法令に準拠して取扱い、本接続のロール権限を超える範囲のデータは返しません。
• トークン紛失時の再表示は提供していません。取消 + 新規作成で対応してください。

※ プラン / 利用範囲 / SLA については個別ご相談ください。