mcp-gateway

Civic MCP Gateway

Civic MCP Gateway を介して AI エージェントをツールやデータに接続すると、MCP ツールの呼び出し時に、ビルダーはガードレール、スコープ付き権限、監査証跡、取り消し可能なアクセスを利用できます。Civic は権限レイヤーを AI エージェントから分離するため、エージェントが制限を回避することはできません。

このリポジトリには、統合メタデータ、設定ファイル、クライアントのサンプルが含まれています。ゲートウェイ自体は app.civic.com で実行されています。

---

できること

ID レイヤーがない場合、AI エージェントは、誰が許可したのか、何にアクセスしたのか、アクセスを取り消す方法について記録がないまま、あらゆる MCP ツールを呼び出せます。Civic はこの問題を解決します。

• エージェントの ID — エージェントは Civic が発行したベアラートークンで認証します
• スコープ付き権限 — エージェントに特定のツールのみへのアクセスを許可します
• 監査証跡 — すべてのツール呼び出しが、エージェントの ID とタイムスタンプとともに記録されます
• 取り消し可能なアクセス — トークンを取り消すと、エージェントは直ちにアクセスできなくなります
• ガードレール — コンフィギュレーターを介して、レート制限、承認ワークフロー、拒否リストを設定できます

---

MCP エンドポイント

https://app.civic.com/hub/mcp

トランスポート： Streamable HTTP 認証： ベアラートークン（app.civic.com で生成）

---

クイックスタート

1. トークンを取得する

app.civic.com にサインインし、オンボーディングフローからベアラートークンを生成します。

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

Claude Desktop — Streamable HTTP ネイティブ対応：

~/Library/Application Support/Claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "civic": {
      "url": "https://app.civic.com/hub/mcp"
    }
  }
}

Claude Code — HTTP トランスポートにネイティブ対応（ブリッジ不要）：

claude mcp add --transport http civic https://app.civic.com/hub/mcp

または、Hub Bridge 経由で stdio を使用します：

claude mcp add civic "npx @civic/hub-bridge"

Cursor — Streamable HTTP ネイティブ対応：

Cursor の MCP 設定に追加します：

{
  "mcpServers": {
    "civic": {
      "url": "https://app.civic.com/hub/mcp"
    }
  }
}

Cline（VS Code）— cline_mcp_settings.json に追加します：

{
  "mcpServers": {
    "civic": {
      "url": "https://app.civic.com/hub/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_CIVIC_TOKEN"
      }
    }
  }
}

Windsurf — Streamable HTTP にネイティブ対応し、ブリッジは不要です：

~/.codeium/windsurf/mcp_config.json に追加します：

{
  "mcpServers": {
    "civic": {
      "serverUrl": "https://app.civic.com/hub/mcp"
    }
  }
}

Windsurf は初回接続時に OAuth を自動的に処理します。

3. オプション：プロファイルに固定する

?profile=your-toolkit を追加すると、ゲートウェイの対象を特定の設定に絞り込めます：

https://app.civic.com/hub/mcp?profile=your-toolkit

自動エージェント（トークンベース認証）

OAuth フローを完了できない非対話型エージェントの場合は、app.civic.com でベアラートークンを生成し、直接渡します：

curl -X POST https://app.civic.com/hub/mcp \
  -H "Authorization: Bearer $CIVIC_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

---

レジストリからインストール

レジストリ	リンク
Smithery	smithery.ai/servers/@civic/civic-mcp-gateway
ClawHub	clawhub.ai/civictechuser/openclaw-civic-skill

使用例

使用例	Civic が追加する機能
Gmail のガードレールと監査	機密情報を含む外部送信をブロックし、メール内容から個人情報（PII）をマスキングし、すべての送信を記録します
Google Calendar のガードレールと監査	イベントの削除を防止し、営業時間内に制限し、外部の出席者をブロックします
PostgreSQL のガードレールと監査	破壊的なクエリをブロックし、読み取り専用アクセスを適用し、機密列をマスキングします

ドキュメント

完全なドキュメントは docs.civic.com をご覧ください。

---

動作するサンプル

Next.js、フェデレーション認証、MCP ツールの可視化を使用した完全なクライアント統合については、civicteam/nexus-demo をご覧ください。

---

ライセンス

MIT