Glympt

Glympt MCP

Glympt MCP は、公式の TypeScript SDK v2 を通じて、有料のテクノグラフィックデータ補完、条件で絞り込んだ見込み顧客検索、保存済みリスト、CSV スナップショットを提供します。ステートレスな 2026-07-28 プロトコルと、SDK の 2025-11-25 互換モードをサポートしています。

2 つの接続方法を実装しています。開発者向けクライアント用の API キーによる stdio 接続と、Glympt ワークスペースの明示的な同意を伴うホスト型 OAuth です。本番環境での API キーのワークフロー、ホスト型 OAuth の検出・トークン更新・接続解除、ChatGPT、Claude Web、Codex での実際の利用呼び出しを検証済みです。また、ループバック登録の修正を展開した後、Cursor デスクトップ 3.23.12 でも OAuth、14 個のツールの検出、実際の利用呼び出しが成功しました。Claude Code は未検証です。

ホスト型 OAuth

OAuth に対応するクライアントに、次の Streamable HTTP URL を追加します。

https://mcp.glympt.com/mcp

Glympt にサインインし、API が有効な有料ワークスペースを選択して、要求されたスコープに同意します。クライアントごとに、それぞれのワークスペース認証が付与されます。アクセスを取り消すには、アカウント設定 → MCP 接続から接続を解除してください。アクセストークンとリフレッシュトークンが無効になります。

ホスト型 OAuth では、ローカルへのインストールも顧客 API キーも必要ありません。「Glympt のクエリ残高とワークスペースの制限を表示して」から始めてください。クライアントごとの手順と現在の検証制限については、公開セットアップガイドを参照してください。

ローカル stdio アダプター

Node.js 22 以降が必要です。API が有効な有料ワークスペースの Glympt API キー設定で、スコープ付き API キーを作成してください。Pro、Business、および対象となるカスタムプランでは API アクセスを利用できます。無料の CSV トライアルクレジットでは、API や MCP にアクセスできません。

クライアントのプライベートな認証情報設定を使って、サーバープロセスの環境に GLYMPT_API_KEY を設定してから、次を実行します。

npx --yes @glympt/[email protected]

実行ファイルは glympt-mcp です。明示的に永続インストールする場合は、次のとおりです。

npm install --global @glympt/[email protected]
glympt-mcp

一般的な stdio クライアントの設定例は次のとおりです。

{
  "mcpServers": {
    "glympt": {
      "command": "npx",
      "args": ["--yes", "@glympt/[email protected]"],
      "env": {
        "GLYMPT_API_KEY": "tk_live_replace_with_your_key"
      }
    }
  }
}

プレースホルダーは有効な認証情報ではありません。実際のキーはプライベートなローカル設定にのみ保存し、共有リポジトリやチャットプロンプトには絶対に保存しないでください。このパッケージは .env ファイルを自動的に読み込みません。ダッシュボードのキーを無効にすると、このアダプターとの接続が解除されます。

変数	必須	デフォルト	用途
GLYMPT_API_KEY	はい	なし	スコープ付きの有料ワークスペース API キー
GLYMPT_API_BASE_URL	いいえ	https://api.glympt.com	HTTPS API のオリジン。開発時は HTTP ループバックも使用できます

設定が不足している場合は、stderr にわかりやすいエラーを出力して終了します。実行時の診断情報には stderr を使用し、stdout には MCP プロトコルメッセージのみを出力します。npm パッケージの実行に tsx、ソースコードのチェックアウト、開発用依存関係は必要ありません。stdio セットアップの詳細。

ソースからビルドして検証する

Node.js 22 以降と pnpm 10.28.2 が必要です。

pnpm install --frozen-lockfile
pnpm check
pnpm lint
pnpm test
pnpm build
pnpm test:package

テストでは、有料 API のモックと実際の SDK クライアントを使用します。制限のある環境では、ソケットテストにループバックアクセスが必要です。パッケージ検証では実際の tarball を調べ、クリーンな一時ディレクトリに本番用依存関係のみをインストールし、最新とレガシーの両プロトコルで、インストールされた実行ファイルと npx コマンドを確認します。これらのテストで本番環境のクレジットが消費されることはありません。

npm のファイル許可リストには、コンパイル済み stdio アダプター、公開セットアップドキュメント、ライセンス、Registry メタデータが含まれています。ホスト型ゲートウェイのランナーとデプロイ設定は、このソースリポジトリでのみ利用できます。Dockerfile は引き続き node dist/hosted.js を使ってホスト型サービスをビルドします。デプロイを参照してください。

ツールとクレジット

ツール	目的	必要なスコープ	クエリークレジット
enrich_domain	キャッシュ済みまたはキューに登録されたドメインのエンリッチメント	lookup:read	正規化されたドメインごとに1つ
enrich_domains	所有するドメイン配列をエンリッチメント	bulk:write	正規化された一意のドメインごとに1つ
get_lookup_job	既存のジョブ／結果	lookup:read	なし
get_enrichment_batch	既存のバッチの進捗	bulk:write	なし
get_batch_results	フィルターされたバッチ結果のページ	bulk:write	なし
search_domains	フィルターされた共有データベースのページ	lookup:read	なし
get_usage	プラン、残高、期間、上限	lookup:read	なし
list_saved_lists	ワークスペースのリストページ	lists:read	なし
get_saved_list	所有するリストと項目のページ	lists:read	なし
create_saved_list	リストを作成	lists:write	なし
add_domain_to_list	ドメインとメモを保存。スキャンは実行しません	lists:write	なし
create_csv_export	完了済みのアップロード、検索、または保存済みリストのスナップショットを作成	exports:read。リストの場合はlists:readも必要	なし
get_csv_export	所有するエクスポートのステータス	exports:read	なし
get_csv_export_chunk	有効期限内で準備完了したCSVの正確なバイト列	exports:read	なし

読み取りやポーリングを含むすべてのリクエストは、ワークスペースのAPIレート上限にカウントされます。クエリーの課金、返金、所有権については、APIが引き続き正となります。MCPは独自の残高を管理しません。

エンリッチメントとリスト／エクスポートの変更には、8～200文字のidempotencyKeyが必要です。実行する操作ごとに、安定した一意のキーを選択してください。応答が失われた場合は、同じ入力で同じキーを再利用してください。新しいキーは新しい操作となり、再度課金される場合があります。このアダプターは、課金対象のリクエストを自動的に再試行しません。タイムアウトやトランスポートのキャンセルは、処理がキャンセルされたことやクレジットが返金されたことを意味しません。

返されたジョブまたはバッチの識別子は、1秒、2秒、4秒、その後は5秒以上の間隔を空けてポーリングしてください。終端ステータスに達したら停止します。検出前に発生した技術的な障害はAPIの台帳ポリシーに従って返金されます。一方、有効な取得処理でテクノロジーが検出されなかった場合や、キャッシュ済みのAPIエンリッチメントは課金対象です。

エクスポートのスナップショットは7日後に期限切れとなります。失敗または期限切れとなったスナップショットでは、元の操作が再実行されます。新しいキーは、新しいエクスポートを意図的にリクエストする場合にのみ使用してください。CSVの数式セルはエスケープされます。ダウンロードチャンクにはテキストの断片ではなく、base64形式のバイト列が含まれます。デコードした後、eofになるまでnextOffsetBytesの順に連結してください。デフォルトのチャンクサイズは48 KiB、最大は64 KiBです。現在、公開CSVダウンロードリンクはありません。クライアントは認証済みチャンクからファイルを再構成します。 テクノロジーフィルターでは、shopify、wordpress、cloudflare などのスラッグを使用します。ページのデフォルト件数は25件、上限は100件です。API の応答サイズ上限は256 KiBです。このバイト数の上限を超える場合は、ページサイズを小さくしてください。国は推定値であり、観測結果にはスキャン日が記録されます。また、ウェブサイト上の情報は信頼できないデータです。

検証状況

• ローカル SDK テストでは、最新およびレガシーのリビジョン、実行可能な stdio、リクエストごとのホスト済み ID の分離、スコープ、応答サイズの制限、認証情報の秘匿化について、14個すべてのツールをテストしています。
• 0041 までの新規の分離されたマイグレーション、バックエンドのユニットテスト230件、OAuth／API ワークフローのテスト15件、既存のバックエンド回帰テスト112件、クレジット復旧チェック27件に合格しています。
• フロントエンドの本番ビルドと、ローカルブラウザーでのサインイン、ワークスペースの同意、PKCE の交換、切断の検証に合格しています。
• 本番環境の API キーを使った stdio の検証に合格しています。SDK プロトコル 2026-07-28、レガシーの 2025-11-25 接続、実際のワーカースキャン、重複／再生時の課金、保存済みリスト、CSV チャンクの再構成、DNS 失敗時の返金を使って、14個すべてのツールを呼び出しました。テストではクエリクレジットを正味2件使用しました。
• Docker／Coolify のデプロイは稼働中です。ホスト型 OAuth では、どちらのプロトコルリビジョンでも14個のツールが検出され、トークンのローテーションに成功しました。また、切断後の Codex アクセストークン／リフレッシュトークンは拒否されます。ChatGPT、Claude web、Codex の実クライアントで、2026-10-04 にクエリ料金が発生しない読み取り専用の利用確認を完了しました。ループバック登録の修正をデプロイした後、Cursor desktop 3.23.12 でも OAuth、14個のツールの検出、実際の利用呼び出しに成功しました。Claude Code は未検証です。

実装計画で受け入れ状況を追跡してください。クライアント UI、実験的な Tasks、自動バックグラウンドポーリング、任意の HTTP フェッチ、データベースへの直接アクセスは、今回のリリースの対象外です。

プロトコルのリファレンス

• 7月28日のプロトコルリリース
• 8月22日のロードマップ更新
• SDK HTTP ハンドラー
• SDK のレガシー互換性
• SDK の認可

配布

バージョン0.1.0はnpmおよび公式 MCP Registryで公開中です。レジストリのメタデータはserver.jsonにあります。確認済みの公開エントリーとディレクトリへの申請については、配布状況をご覧ください。

ライセンス

MCP アダプターは MIT ライセンスです。LICENSEをご覧ください。Glympt サービスへのアクセスには、引き続きワークスペースのサブスクリプション、スコープ、サービス利用規約が適用されます。