DATPAQ について
DATPAQは、Datpaqの本番APIエンドポイントをMCPクライアント向けのツールとして公開するホスト型MCPサーバーです。複数のプロトコル世代でHTTP接続でき、ローカルへのインストールやセルフホストにも対応しています。
主な機能
- 01有効なDatpaq API向けツール
- 02Streamable HTTPトランスポート
- 03リクエストごとのAPIキー認証
- 04新旧MCPプロトコルに対応
- 05ローカル導入とセルフホスト
活用シーン
- 01MCPクライアントからDatpaq APIを呼び出す
- 02共有ホスト型エンドポイントへの接続
- 03ローカルまたは自前環境での実行
MCP 対応
有効なDatpaq APIエンドポイントを、Streamable HTTP経由でMCPツールとして公開します。各リクエストにDatpaq APIキーが必要で、新旧のプロトコルバージョンに対応します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.datpaq.com/mcpclaude mcp add --transport http com-datpaq-datpaq https://mcp.datpaq.com/mcp{"mcpServers":{"com-datpaq-datpaq":{"type":"http","url":"https://mcp.datpaq.com/mcp"}}}Cursor で開く{"servers":{"com-datpaq-datpaq":{"type":"http","url":"https://mcp.datpaq.com/mcp"}}}VS Code で開く{"mcpServers":{"com-datpaq-datpaq":{"type":"http","url":"https://mcp.datpaq.com/mcp"}}}{"mcpServers":{"com-datpaq-datpaq":{"serverUrl":"https://mcp.datpaq.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://mcp.datpaq.com/mcp認証が必要ツール
詳細
Datpaq MCP サーバー
Datpaq API 用のホスト型 Model Context Protocol サーバーです。
https://mcp.datpaq.com/ でホストされています。ローカルにもインストールでき、セルフホストも可能です。
datpaq-mcp-http は、ストリーミング可能な HTTP 経由で Datpaq API を MCP ツールとして公開します。これにより、MCP 対応クライアント(Claude Desktop、Cursor、Codex、Cline、Continue、エージェントフレームワーク)は、1 回の接続で Datpaq エンドポイントを呼び出せます。
ローカル CLI(および Claude Desktop 用に付属する stdio MCP)については、github.com/datpaq/cli をご覧ください。
接続
| URL | https://mcp.datpaq.com/ |
| トランスポート | ストリーミング可能な HTTP |
| プロトコル | 2026-07-28 および 2025-11-25(以前のバージョンも対応) — プロトコルバージョンを参照 |
| 認証 | Authorization: Bearer YOUR_DATPAQ_API_KEY(リクエストごと) |
| ツール | 63 の有効な API にわたるホスト型ツール |
curl で確認できます — 最新版(2026-07-28):
curl -s -X POST https://mcp.datpaq.com/ -H "Authorization: Bearer $YOUR_DATPAQ_API_KEY" -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -H "MCP-Protocol-Version: 2026-07-28" -H "Mcp-Method: server/discover" -d '{"jsonrpc":"2.0","id":1,"method":"server/discover","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"curl","version":"0"},"io.modelcontextprotocol/clientCapabilities":{}}}}'
または、従来版(initialize ハンドシェイク)。こちらも従来どおり引き続き動作します。
curl -s -X POST https://mcp.datpaq.com/ -H "Authorization: Bearer $YOUR_DATPAQ_API_KEY" -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'
プロトコルバージョン
このサーバーは両世代に対応しており、同じエンドポイントでステートレスな 2026-07-28 リビジョンと、ハンドシェイクベースのリビジョン(2025-11-25 以前)の両方を処理し、リクエストごとに適切なバージョンを選択します。設定は不要です。クライアントから URL に接続するだけで、対応しているバージョンが使用されます。
| 世代 | バージョン | 提供方法 |
|---|---|---|
| 最新 | 2026-07-28 | ステートレスです。すべてのリクエストで、バージョン、クライアント情報、機能を _meta に含め、MCP-Protocol-Version/Mcp-Method/Mcp-Name ヘッダーにも反映します。server/discover、tools/list、tools/call を実装しています。 |
| 従来 | 2025-11-25、2025-06-18、2025-03-26、2024-11-05 | 従来どおりの initialize ハンドシェイクです。セッション、GET SSE ストリーム、Mcp-Session-Id はすべて引き続き動作します。 |
最新世代についての補足:
tools/listとserver/discoverは、キャッシュのヒントとしてttlMsとcacheScope: "public"を返します。ツールカタログはすべてのテナントで同一で、再デプロイ時にのみ変更されます。そのため、クライアントはカタログをキャッシュし、再接続のたびに各ツール定義を再取得せずに済みます。Mcp-MethodとMcp-Nameは、リクエスト本文と照合して検証されます。ヘッダーが本文と一致しない場合は-32020 HeaderMismatchで拒否されます。一方、ヘッダーがない場合もリクエストは処理されるため、ヘッダーの反映にまだ対応していないクライアントも引き続き動作します。- サポートされていないバージョンが指定されると、サポート対象のバージョンを列挙した
400+-32022が返されるため、クライアントは失敗せずに再試行できます。 2026-07-28で仕様上非推奨となった機能(roots、sampling、logging、DCR、2024-11-05の HTTP+SSE トランスポート)は、このサーバーではこれまで使用されていません。そのため、変更はありません。
認証モデル: すべてのリクエストで、Datpaq API キーを Authorization: Bearer <key> として提示する必要があります。サーバー自体は認証情報を保持しないため、1 つのインスタンスで複数のテナントにサービスを提供でき、料金はそれぞれの Datpaq アカウントに請求されます。
クライアントを設定
Claude Desktop(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"datpaq": {
"url": "https://mcp.datpaq.com/",
"headers": {
"Authorization": "Bearer YOUR_DATPAQ_API_KEY"
}
}
}
}
Cursor(~/.cursor/mcp.json またはプロジェクトの .cursor/mcp.json):
{
"mcpServers": {
"datpaq": {
"url": "https://mcp.datpaq.com/",
"headers": {
"Authorization": "Bearer YOUR_DATPAQ_API_KEY"
}
}
}
}
Codex CLI:
export DATPAQ_API_KEY="YOUR_DATPAQ_API_KEY"
codex mcp add datpaq --url https://mcp.datpaq.com/ --bearer-token-env-var DATPAQ_API_KEY
Codex TOML:
[mcp_servers.datpaq]
url = "https://mcp.datpaq.com/"
bearer_token_env_var = "YOUR_DATPAQ_API_KEY"
Cline や Continue を含む各クライアントの詳しい手順については、Datpaq MCP ドキュメントをご覧ください。
セルフホスト
Go を使ってインストールします。
go install github.com/datpaq/mcp/cmd/datpaq-mcp-http@latest
Go 1.26.3 以降が必要です。
または、Docker イメージを取得します。
docker build -t datpaq-mcp-http -f cmd/datpaq-mcp-http/Dockerfile .
docker run -p 8080:8080 datpaq-mcp-http
実行します。
datpaq-mcp-http --addr :8080
次に、MCP クライアントから http://localhost:8080/ に接続します。
ワンコマンドでデプロイできる Fly.io の設定が付属しています。
fly launch --config fly.toml
fly deploy
設定が必要なシークレットはありません。クライアントはリクエストごとに認証します。
公開される内容
サーバーは、アクティブな Datpaq API エンドポイントごとに 1 つの MCP ツールを登録します。アクティブなエンドポイントは internal/cli/active-apis.json で管理されています。datpaq.com で新しい API がリリースされたら、そこにスラッグを追加して再デプロイすると、接続しているすべてのクライアントにそのツールが表示されます。
非アクティブな API は MCP の公開対象から完全に除外されます(CLI では引き続き直接呼び出せます)。これにより、ホストされたツール一覧を本番環境で利用可能なエンドポイントに絞り込めます。
ローカル状態に依存するツールや、ユーザーのマシン上でシェルコマンドを実行するツール(認証フロー、設定ファイルの書き込みなど)は意図的に登録されません。詳しくは internal/mcp/public_tools.go を参照してください。
設定
| 変数 | 用途 |
|---|---|
DATPAQ_BASE_URL | API のベース URL を上書きします(デフォルト:https://datpaq.com/api/v1)。ステージング環境への接続に便利です |
PORT | HTTP の待ち受けポート(デフォルト:8080。--addr でも設定できます) |
Datpaq API キーはサーバー側の変数ではありません。各リクエストに Authorization: Bearer <key> として含める必要があります。Quickstart の認証モデルを参照してください。
アクティブな API の管理
アクティブなエンドポイントは internal/cli/active-apis.json で管理されています。このマニフェストを管理ダッシュボードのエクスポートから再生成する(または Phase 2 で GET /api/v1/catalog/active を使う)ための正規の場所は CLI リポジトリです。このリポジトリには同期によって更新が反映されます。独自の取得ツールは含まれていません。
{
"active": [
"convert-time",
"ip-geolocation",
"..."
]
}
正規のワークフロー(隣接するチェックアウトを ../CLI に配置):
# In the CLI repo
cd ../CLI
make fetch-active-apis CATALOG_INPUT=./export.json # or CATALOG_URL=... after Phase 2
make sync-active-apis # CLI → MCP
# Then here
make build && make test
# commit internal/cli/active-apis.json + code changes, deploy
誤ってこのリポジトリで active-apis.json を編集した場合は、./scripts/sync-active-apis.sh を使って CLI に反映してください(MCP → CLI の一方向のみ)。通常の更新では、上記の CLI を先に更新するフローを推奨します。
開発
git clone https://github.com/datpaq/mcp && cd mcp
make build
./bin/datpaq-mcp-http --addr :8080
テストを実行します。
make test
ライセンス
Apache 2.0 — LICENSE を参照してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。