Respan 用の Model Context Protocol (MCP) サーバー - AI アシスタントから直接ログ、プロンプト、トレース、顧客データにアクセスできます。
ログ - LLM リクエストログのクエリ、フィルタリング、作成
トレース - スパンツリーを含む完全な実行トレースの表示
顧客 - 顧客データと予算情報へのアクセス
プロンプト - プロンプトテンプレートとバージョンの管理
Related MCP server: MCP Datadog Server
インストールは不要です。
platform.respan.ai から API キーを取得します
MCP 設定ファイルに追加します：
Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"respan": {
"url": "https://mcp.respan.ai/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_RESPAN_API_KEY"
}
}
}
}Claude Desktop (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"respan": {
"url": "https://mcp.respan.ai/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_RESPAN_API_KEY"
}
}
}
}Cursor/Claude Desktop を再起動します
個人開発やオフライン使用のために MCP サーバーをローカルで実行します。
前提条件: Node.js v18+
git clone https://github.com/respanai/respan-mcp.git
cd respan-mcp
npm install
npm run build{
"mcpServers": {
"respan": {
"command": "node",
"args": ["/absolute/path/to/respan-mcp/dist/lib/index.js"],
"env": {
"RESPAN_API_KEY": "YOUR_RESPAN_API_KEY"
}
}
}
}単一のデプロイメントを共有するチーム向けに、独自のインスタンスを Vercel にデプロイします。
Vercel ダッシュボード > 設定 > 環境変数で RESPAN_API_KEY を設定します。
この設定をチームで共有します：
{
"mcpServers": {
"respan": {
"url": "https://your-project.vercel.app/mcp"
}
}
}ツール | 説明 |
| アカウントが操作できる組織と、アクティブな組織を一覧表示します |
| 名前、 |
他のすべてのツールは、アクティブな組織のみを読み書きします。切り替えは アカウント全体に及び、永続的です。バックエンドがアクティブな組織をトークンではなくユーザーレコードに保存するため、Respan ウェブアプリや他のセッションも同じ組織に移動します。OAuth ログインが必要です。API キーはすでに 1 つの組織にバインドされており、切り替えることはできません。
ツール | 説明 |
| 強力なクエリ機能で LLM リクエストログを一覧表示およびフィルタリングします |
| 一意の ID で単一のログの完全な詳細を取得します |
| あらゆるタイプの LLM リクエストの新しいログエントリを作成します |
ツール | 説明 |
| 並べ替えとページネーションでトレースを一覧表示およびフィルタリングします |
| トレースの完全な階層スパンツリーを取得します |
ツール | 説明 |
| ページネーションと並べ替えで顧客を一覧表示します |
| 予算使用量を含む顧客の詳細を取得します |
ツール | 説明 |
| 組織内のすべてのプロンプトを一覧表示します |
| 詳細なプロンプト情報を取得します |
| プロンプトのすべてのバージョンを一覧表示します |
| 特定のバージョンの詳細を取得します |
ツール | 説明 |
| 自動化、モニター、スケジュールされたエクスポート、評価パイプラインを一覧表示します |
| タイプやその他のフィールドでワークフローをフィルタリングします |
| ワークフローとそのタスク定義を取得します |
| イベント駆動型の自動化を作成します。必要なダッシュボードサンプリングゲートを追加します |
| 集計/条件タスクと配信タスクからモニターを作成します |
| cron とエクスポート固有のオプションからスケジュールされたエクスポートを作成します |
| 高度な低レベルワークフロー作成のエスケープハッチ |
| 編集可能なワークフロードラフトを更新します |
| ワークフローファミリーとすべてのバージョンを削除します |
| ワークフローファミリー内のバージョンを一覧表示します |
| 特定のワークフローバージョンを取得します |
| 現在のドラフトをコミットします |
| コミットされたワークフローバージョンをデプロイします |
| デプロイされたワークフローを停止します |
| サンプルデータに対してワークフロータスクを検証します |
バックエンドルートは共有されていますが、MCP 作成関数は意図的に分離されています。自動化はイベント駆動型のタスクパイプラインであり、ダッシュボード互換の auto-sampling ゲートを受け取ります。モニターは集計、条件、配信タスクを受け入れ、通知またはウェブフックが必要です。エクスポートは UTC 5 フィールドの cron に加えて、エクスポート固有のフィルター、フィールド、インライン結果の動作、サンプリングを受け入れます。
フィルタリングをサポートするツールは、filters オブジェクトを受け入れます：
{
"cost": {"operator": "gt", "value": [0.01]},
"model": {"operator": "", "value": ["gpt-4"]},
"customer_identifier": {"operator": "contains", "value": ["user"]},
"metadata__session_id": {"operator": "", "value": ["abc123"]}
}演算子: "" (等しい)、not、lt、lte、gt、gte、contains、icontains、startswith、endswith、in、isnull
respan-mcp/
├── api/
│ └── mcp.ts # HTTP entry point (Vercel serverless function)
├── lib/
│ ├── index.ts # Stdio entry point (local mode)
│ ├── shared/
│ │ └── client.ts # API client, auth config, path validation
│ ├── observe/
│ │ ├── logs.ts # list_logs, get_log_detail, create_log
│ │ ├── traces.ts # list_traces, get_trace_tree
│ │ └── users.ts # list_customers, get_customer_detail
│ ├── account/
│ │ └── organizations.ts # list_organizations, switch_organization
│ └── develop/
│ └── prompts.ts # list_prompts, get_prompt_detail, versions
├── vercel.json # Vercel config (rewrites, function timeout)
├── tsconfig.json # TypeScript config
└── package.json2 つのエントリポイント: api/mcp.ts (Vercel 経由の HTTP) と lib/index.ts (ローカル使用の stdio)
共有コア: 両方のエントリポイントが AuthConfig を作成し、クロージャを介して同じツール登録関数に渡します - グローバルな可変状態はありません
ツールモジュール: ドメインごとに編成 (observe/ はランタイムデータ、develop/ はプロンプト管理)
API クライアント: lib/shared/client.ts は、30 秒のタイムアウト、パス検証、認証を備えたすべてのアップストリーム API 呼び出しを処理します
カスタム API エンドポイントの場合は、RESPAN_API_BASE_URL 環境変数を設定します：
Stdio モード:
{
"mcpServers": {
"respan": {
"command": "node",
"args": ["/path/to/respan-mcp/dist/lib/index.js"],
"env": {
"RESPAN_API_KEY": "YOUR_API_KEY",
"RESPAN_API_BASE_URL": "https://your-endpoint.example.com/api"
}
}
}
}プライベートデプロイメント: Vercel 環境変数で RESPAN_API_BASE_URL を設定します。
npm run build # Compile TypeScript
npm run stdio # Build and run in stdio modeこのリポジトリには、パブリック OAuth および MCP ルート用の Vercel に依存しない HTTP ハーネスが含まれています。既存のローカルバックエンドと Redis サービスを使用します。どちらのサービスも開始、再起動、クリアしません。
gitignore された .env.local を作成します：
OAUTH_SECRET=<locally-generated-random-secret-of-at-least-32-characters>
OAUTH_SESSION_STORE=redis
REDIS_URL=redis://127.0.0.1:6379/15
MCP_REDIS_KEY_PREFIX=respan-mcp:local:
MCP_PUBLIC_BASE_URL=http://127.0.0.1:3100
MCP_ACCESS_TOKEN_TTL_SECONDS=60
RESPAN_API_BASE_URL=http://127.0.0.1:8000/api
RESPAN_ENTERPRISE_API_BASE_URL=http://127.0.0.1:8000/api
# Used only by the complete local verification probe:
OAUTH_TEST_EMAIL=<local-test-account-email>
OAUTH_TEST_PASSWORD=<local-test-account-password>
# Required by the platform probe's API-key compatibility check.
OAUTH_TEST_API_KEY=<local-test-api-key>
# Optional; defaults to platform. Also accepts enterprise.
OAUTH_TEST_REALM=platformVercel が使用するのと同じ Upstash REST アダプターを試すには、ローカル Redis 設定を次のように置き換えます：
OAUTH_SESSION_STORE=upstash
UPSTASH_REDIS_REST_URL=<upstash-rest-url>
UPSTASH_REDIS_REST_TOKEN=<upstash-rest-token>ローカルキープレフィックスは、Preview および Production とは別にしておきます。プローブは常にそれを実行ごとに一意のプレフィックスに置き換え、それらのキーのみを削除します。
手動ブラウザテストの場合は、ローカルサービスを実行します：
npm run dev:oauth自動検証コマンドは独自の分離されたブローカーハーネスを起動するため、別の dev:oauth プロセスなしで実行します：
npm run verify:oauth:localエンタープライズリソースとバックエンドを通じて同じライフサイクルを試すには、次を実行します：
OAUTH_TEST_REALM=enterprise npm run verify:oauth:localリフレッシュローテーションが絶対的なリフレッシュセッションの期限を延長しないことを確認するには、短いローカル有効期間でプローブを実行します：
OAUTH_VERIFY_REFRESH_EXPIRY=true \
MCP_REFRESH_SESSION_TTL_SECONDS=180 \
npm run verify:oauth:localプローブは、アクセストークンの有効期限が切れた後にリフレッシュトークンをローテーションし、元のセッション発行から 3 分待ってから、最新のリフレッシュトークンに invalid_grant を要求します。この設定はローカル検証専用です。
プローブは、127.0.0.1:3100 で独自の分離されたハーネスを起動し、一意の Redis キープレフィックスを使用し、ステップのステータスと期間のみを出力し、その一意のプレフィックスの下のキーのみを削除します。同じポートで dev:oauth を同時に実行しないでください。Google ログインには、個別に設定されたローカルバックエンド資格情報が必要です。決定論的な自動スイートは、それらなしでブローカーの動作をカバーします。
ホスト型 OAuth クライアント登録は、HTTPS コールバックとループバックにバインドされた HTTP コールバック（リテラルアドレス 127.0.0.1 と [::1]、またはホスト名 localhost。これは Claude Code と MCP Inspector が登録するものです）を受け入れます。ホスト名の一致は完全一致であるため、localhost.attacker.example と sub.localhost はループバックではありません。他の HTTP ホスト、実行可能な URL スキーム、資格情報、フラグメント、重複するコールバック、および過度に大きなコールバックリストは拒否されます。
Vercel デプロイメントには、インメモリストアではなく Upstash が必要です。本番のパブリックおよびバックエンド URL は HTTPS を使用する必要があり、OAuth シークレットと Redis 資格情報は、デプロイメントシークレットマネージャーを介してのみ設定する必要があります。
完全な Preview および Production のセットアップ、環境変数マトリックス、Vercel サービス設定、検証ゲート、監視、ロールバック手順については、Public MCP OAuth Broker: Vercel Deployment Runbook を参照してください。
自動チェック：
npm test
TEST_REDIS_URL=redis://127.0.0.1:6379/15 npm test -- --run tests/redis-store.integration.test.ts
npm run build
git diff --check完全なドキュメントは docs.respan.ai/documentation/resources/mcp にあります
MIT
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Read-only access to Auralogs production logs: search logs, inspect errors, review AI analyses.
AI access to Hitsteps analytics, live visitors, uptime, goals, alerts, and chats.
AI agent run monitoring with incident replay and SLA receipts.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/respanai/respan-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server