Perigon MCP Server

Perigon MCP

リアルタイムのニュース、エンティティ、モニターに対応した Perigon のホスト型 MCP サーバーです。

• 🚀 クイックスタート
• 🔐 認証
• 🔧 ツールの選択
• 🛠️ ツール
• 📚 プロンプトとリソース
• 📊 Signal Insights ワークフロー
• 💡 プロンプトのヒント
• 📦 MCP Registry
• 💻 ローカル開発
• 👥 貢献とメンテナー
• ⚖️ ライセンス

---

クイックスタート

エンドポイント：https://mcp.perigon.io/v1/mcp

プレイグラウンドでお試しください（サインイン済みのPerigon ダッシュボードのセッションが必要です）。人間向けのセットアップ手順：perigon.io/docs/api/mcp。エージェントを使ってインストールする場合： perigon.io/mcp.mdを AI クライアントに渡し、手順に従ってください（OAuth でサインインするため、チャットに API キーを入力する必要はありません）。

OAuth（推奨）

サーバー URL のみを追加します。初回接続時に、クライアントが OAuth メタデータを検出し、Perigon サインインを開きます。認証を参照してください。

ネイティブの Streamable HTTP：

{
  "mcpServers": {
    "perigon": {
      "url": "https://mcp.perigon.io/v1/mcp",
      "type": "http"
    }
  }
}

ネイティブ HTTP に対応していないクライアント向けの mcp-remote：

{
  "mcpServers": {
    "perigon": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.perigon.io/v1/mcp"]
    }
  }
}

Claude Code：

claude mcp add --transport http perigon https://mcp.perigon.io/v1/mcp

その後、Claude Code で /mcp を実行し、プロンプトが表示されたら認証を選択します。

Codex CLI — ~/.codex/config.toml に追加します：

[mcp_servers.perigon]
url = "https://mcp.perigon.io/v1/mcp"

その後、codex mcp login perigon を実行します。

API キー（スクリプトおよび固定キー）

クライアントが OAuth を完了できない場合、または設定に固定キーが必要な場合に使用します。perigon.io/dev/keysからキーを取得できます。

ネイティブの Streamable HTTP：

{
  "mcpServers": {
    "perigon": {
      "url": "https://mcp.perigon.io/v1/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_PERIGON_API_KEY"
      }
    }
  }
}

mcp-remote：

{
  "mcpServers": {
    "perigon": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.perigon.io/v1/mcp",
        "--header",
        "Authorization: Bearer ${PERIGON_API_KEY}"
      ],
      "env": {
        "PERIGON_API_KEY": "YOUR_PERIGON_API_KEY"
      }
    }
  }
}

Claude Code：

claude mcp add --transport http perigon https://mcp.perigon.io/v1/mcp \
  --header "Authorization: Bearer YOUR_PERIGON_API_KEY"

レガシークライアント向けに /v1/sse の SSE も用意されています。新しい連携には Streamable HTTP を使用してください。

---

認証

MCP エンドポイントは、次の 2 種類の**Authorization: Bearer**認証情報を受け付けます。

方法	Bearer の値	最適な用途
OAuth	Perigon の認可フローで取得した MCP アクセストークン	デスクトップおよび IDE の MCP クライアント。アクセス権は組織のメンバーシップに従います
API キー	開発者ダッシュボードで取得した Perigon API キー	スクリプト、mcp-remote、またはキーを固定する設定

OAuth

ホスト型ディスカバリー（本番環境）：

• 保護対象リソース：https://mcp.perigon.io/.well-known/oauth-protected-resource（別名：https://mcp.perigon.io/.well-known/oauth-protected-resource/v1/mcp）
• 認可サーバーのメタデータ：https://mcp.perigon.io/.well-known/oauth-authorization-server

クライアントは認可サーバーのメタデータから、認可、トークン、登録の各エンドポイントを検出します（PKCE が必須です）。

クライアントは PKCE を使用する標準の認可コードフローを完了し、その後、結果として得られたアクセストークンをすべての MCP リクエストに含めます。

• サインインには、組織でユーザー以上のロールを持つ、認証済みの Perigon ユーザーが必要です。
• 使用料金は組織に請求されます。クライアントで API キーは必要ありません。
• MCP アクセスの取り消しやメンバーの削除は、次のリクエストから反映されます。

認証されていないリクエストには、保護対象リソースのメタデータ URL を示す WWW-Authenticate ヘッダー付きの 401 が返されます。

API キー

perigon.io/dev/keys でキーを作成またはコピーし、クライアントの Authorization ヘッダーに設定します（クイックスタートの例を参照）。スコープとクォータは、そのキーに従います。

---

ツールの選択

MCP URL に ?tools= を追加して、セッションの範囲を絞り込みます。?tool= は別名で、両方が指定されている場合は ?tool= が優先されます。

https://mcp.perigon.io/v1/mcp?tools=search_news_articles,search_news_stories
https://mcp.perigon.io/v1/mcp?tools=research
https://mcp.perigon.io/v1/mcp?tools=research,create_monitor
https://mcp.perigon.io/v1/mcp?tools=all

• ツール名、プロファイルのエイリアス、またはその組み合わせをカンマ区切りで指定します。
• フィルターは、認証情報で許可されている範囲（API キーのスコープ、または OAuth での組織の MCP アクセス）との積集合になります。アクセス範囲を拡張することはできません。
• パラメーターを省略するか、空の値を指定すると、デフォルトのセットが使用されます（オプトインツールはオフのままになり、トークン節約のためツール一覧が少なくなります）。
• all を指定すると、スコープで許可されたデフォルトツールに加えて、すべてのオプトインカタログツール（モニターの書き込み、プラットフォームヘルパー、get_source_by_id、get_top_topics、get_story_stats など）が含まれます。スコープで制限された検索ツールには、引き続き該当する権限が必要です。
• 不明な名前は除外されます。すべての名前が不明な場合は、デフォルトのセットが使用されます。

プロファイル	ツール
research	search_news_articles、search_news_stories、search_story_history、search_vector_news、summarize_news、search_journalists、search_sources、search_people、search_companies、search_topics、5 つの統計ツール、get_top_topics、get_source_by_id、get_api_access。Wikipedia と、会社／人物／場所のショートカットは含まれません。
monitoring	すべてのモニターツール（create_monitor／update_monitor を含む）と、すべての Signal Insights ツール。
platform	watchlists、create_watchlist、update_watchlist、source_groups、create_source_group、update_source_group、contact_points、article_refresh、get_api_access。
minimal	search_news_articles、5 つの統計ツール、get_api_access。

get_story_stats はどのプロファイルにも含まれていません。名前を指定してリクエストしてください。CLUSTERS スコープが必要です。

---

ツール

利用可能性：

• デフォルト — ?tools= が省略された場合に登録されます（該当するスコープが記載されている場合、キーがそのスコープを持つことが条件です）。
• スコープ — キーが該当する権限を持つ場合にのみ登録されます。
• オプトイン — デフォルトのセットから除外されます。名前、プロファイル、または ?tools=all でリクエストします。登録されていることは、API アクセスが許可されていることと同じではありません。

検索

ツール	利用可否	説明
search_news_articles	デフォルト	ブール検索を含む、個別記事のキーワード検索とフィルター検索です。
search_news_stories	スコープ：CLUSTERS	関連記事をひとつのストーリーにまとめた、クラスタ化された見出しです。
search_story_history	スコープ：CLUSTERS	ストーリーのクラスタがどのように変化したかを示す、タイムスタンプ付きのスナップショットです。
search_vector_news	スコープ：VECTOR_SEARCH_NEWS	最近の記事のセマンティック検索です。
summarize_news	スコープ：SEARCH_SUMMARY	該当する記事を引用付きで AI が要約します。
search_journalists	スコープ：JOURNALISTS	ジャーナリストや記者のプロフィールです。
search_sources	スコープ：SOURCES	ニュースの出版物や報道機関です。
search_people	スコープ：PEOPLE	著名人のプロフィールです。
search_companies	スコープ：COMPANIES	企業のプロフィール（ドメイン、ティッカー、業種）です。
search_topics	スコープ：TOPICS	トピックを正確に絞り込むための、Perigon のトピック分類体系です。
search_wikipedia	スコープ：WIKIPEDIA	Wikipedia のページをキーワード検索します。
search_vector_wikipedia	スコープ：VECTOR_SEARCH_WIKIPEDIA	Wikipedia のページをセマンティック検索します。

ショートカット

各ツールはエンティティを検索し、その後、そのエンティティに関する最近の記事を検索します。

ツール	利用可否	説明
get_company_news	スコープ：COMPANIES	名前から検索した企業に関する最近の記事です。
get_person_news	スコープ：PEOPLE	名前から検索した人物に関する最近の記事です。
get_location_news	スコープ：LOCATIONS	市、州、国に関する最近の記事です。

統計

有効なキーであれば、常に利用できます。検索結果を手作業で数えるより、こちらを優先してください。

ツール	利用可否	説明
get_avg_sentiment	デフォルト	時間ごとに分類した、感情（ポジティブ／ネガティブ／ニュートラル）の平均値です。
get_article_counts	デフォルト	時間ごとに分類した記事の公開数です。
get_top_entities	デフォルト	最も多く言及されたトピック、人物、企業、都市、ジャーナリスト、報道機関です。
get_top_people	デフォルト	基準値と比較して報道が急増している人物です。
get_top_companies	デフォルト	基準値と比較して報道が急増している企業です。

アクセス

ツール	利用可否	説明
get_api_access	デフォルト	このキーのスコープ、組織、クォータ、利用権限の動作を確認します。リクエストのクォータにはカウントされません。セッションごとに1回、または403の後に呼び出してください。

モニター

読み取りツールはデフォルトで有効です。共有モニタースキーマが大きいため、書き込みツールはオプトインです。

ツール	利用可否	説明
list_monitors	デフォルト	UUID、名前、ステータス、または EVENT / MENTIONS / TOPIC でモニターを一覧表示および絞り込みます。
get_monitor	デフォルト	モニターの全設定を取得します。
get_monitor_events	デフォルト	EVENT および MENTIONS モニターの構造化イベントを取得します。
get_monitor_newsletters	デフォルト	定期配信されるブリーフィングを取得します。通常は TOPIC モニターからのものです。
get_monitor_summaries	デフォルト	AI が生成した、随時更新されるモニター要約の履歴を取得します。
set_monitor_status	デフォルト	モニターを有効化、一時停止、またはアーカイブします。アーカイブは公開 API から取り消せません。
create_monitor	オプトイン	DRAFT または ACTIVE のモニターを作成します。デフォルトは DRAFT です。
update_monitor	オプトイン	部分更新を行います。省略したフィールドは保持されます。

schedulePolicy の時刻と曜日は、Perigon 製品の配信設定と同様に、timezoneId の現地時刻です。公開 API ではこれらの時間帯が UTC で保存され、このサーバーが読み取り時と書き込み時に変換します。America/Chicago の午前 3:00 の日次ブリーフィングは、hour: 8 ではなく hour: 3 として返され、受け付けられます。get_monitor には、人が読める Schedule: の行も含まれます。月次スケジュールでは、設定された daysOfMonth（31 日を含む）が保持されます。24 を超える時間帯を含む複雑なモニターは、返されるスケジュールを MCP 経由で更新できるように、読み取り時に損失を伴う週次変換に切り替わります。変換後に時間帯が 24 を超える書き込みは、近似変換ではなく拒否されます。

プラットフォーム

これらはすべてオプトインです。get_source_by_id と get_top_topics は research にも含まれます。get_story_stats は名前のみのツールです。

ツール	利用可否	説明
get_source_by_id	オプトイン	正確な ID またはドメインを指定して、ニュースソースを 1 件取得します。
get_top_topics	オプトイン	基準値と比べて報道が急増しているトピックを取得します。
get_story_stats	オプトイン；スコープ：CLUSTERS	記事レベルの公開量または時間経過に伴う公開速度を取得します。
watchlists	オプトイン	組織のウォッチリストを一覧表示、取得、または解決します。
create_watchlist / update_watchlist	オプトイン	ウォッチリストを作成または部分更新します。
source_groups	オプトイン	カスタムソースグループのバンドルを一覧表示、取得、または解決します。
create_source_group / update_source_group	オプトイン	ソースグループを作成または部分更新します。
contact_points	オプトイン	モニター通知チャネル（メール／Webhook）を一覧表示または取得します。
article_refresh	オプトイン	更新ジョブの状態を確認するか、最大 100 件の記事 ID のキャッシュデータを参照します。読み取り専用です。

Signal Insights

?tools=で除外されない限り、すべてのセッションに登録されます。

monitoringプロファイルにはこのセットが含まれています。Signal Insights専用のプロファイルはありません。これらだけを使いたい場合は、ツール名を渡してください。

ツール	利用可否	説明
signal_insights_create_workspace	デフォルト	ワークスペースを作成します。会話の開始時に一度呼び出してください。
signal_insights_search_signals	デフォルト	名前または目的でシグナルを検索します。
signal_insights_read_signal	デフォルト	シグナルのメタデータ（分類、スキーマ、ニュースレター数）を取得します。
signal_insights_list_newsletters	デフォルト	TOPICシグナルのニュースレターのタイトルと抜粋を取得します。
signal_insights_read_newsletter	デフォルト	ニュースレターの全内容をMarkdown形式で取得します。
signal_insights_export_events	デフォルト	EVENT / MENTIONSイベントをワークスペースにエクスポートします。プレビューとファイルパスを返します。
signal_insights_execute_code	デフォルト	ワークスペースでPython分析を実行します（pandas、numpy、matplotlib）。
signal_insights_preview_chart	デフォルト	インタラクティブなチャートビューアーでチャートを表示します。
signal_insights_shell	デフォルト	ワークスペースでシェルコマンドを実行します。
signal_insights_list_files	デフォルト	ワークスペース内のファイルを一覧表示します。
signal_insights_read_file	デフォルト	ワークスペースのファイルを読み取ります。
signal_insights_write_file	デフォルト	ワークスペースにファイルを書き込みます。
signal_insights_grep	デフォルト	ファイルの内容を正規表現で検索します。
signal_insights_str_replace	デフォルト	ファイル内の文字列を検索して置換します。

---

プロンプトとリソース

MCPプロンプトに対応したホストでは、次のプレイブックを呼び出せます。

• entity_deep_dive
• narrative_trace
• coverage_trend
• journalist_beat_profile
• competitive_landscape
• spike_explainer

オンデマンドの参照リソース：

• perigon://reference/fields — レスポンスフィールドの意味
• perigon://reference/chaining — エンドポイントを横断する調査プレイブック
• perigon://reference/entitlements — このセッションにおけるスコープと動作の対応表
• perigon://reference/charts — Signal Insightsのチャート書式ルール

MCP Appsビューアー（Signal Insightsのツールが有効な場合に登録）：

• ui://signal-insights/chart-viewer
• ui://signal-insights/export-viewer

---

Monitors Insightsのワークフロー

1. 会話の開始時にsignal_insights_create_workspaceを一度呼び出します。
2. 以降のすべての分析ツールに、返されたワークスペースIDを渡します。
3. 永続ファイルはartifacts/以下に保存されます（エクスポートとクエリ結果は自動的にここに保存されます）。ユーザー向けの成果物はartifacts/output/に配置してください。ファイルツールとシェルツールはワークスペース内の他の場所にも書き込めますが、永続ストレージにバックアップされるのはartifacts/のみです。
4. サンドボックスの再起動後も、ワークスペースIDは有効です。Jupyterカーネルとメモリ内のPython状態はリセットされますが、artifacts/以下のファイルは保持されます。新しいサンドボックスでは、その他のワークスペースパスが空になっている場合があります。

---

プロンプトのヒント

現在の日付（または日付ツール）をモデルに伝えてください。伝えない場合、一部のモデルは知識のカットオフを「今日」と見なして古いニュースを取得することがあります。

例：

• 今日の米国の政治関連ヘッドライン上位5件。
• 今週のカリフォルニアの最新テクノロジーニュース。
• 再生可能エネルギーを担当するジャーナリストを探し、最近の記事を表示してください。
• Teslaを検索し、関連する最近のニュースを探してください。
• アクティブなイベントモニターを一覧表示し、そのうち1つの最新イベントを表示してください。
• 半導体業界の幹部の退任を対象としたモニターの下書きを作成してください。

ChatGPT プラグインのスキル

OpenAI のプラグイン形式に関するワークフローの手順は、skills/ にあります。各スキルは SKILL.md ファイル（YAML の name と description、続いて手順）を含むフォルダーです。スキルとスキルの作成をご覧ください。

スキル	ディレクトリ	トリガー
ニュース調査	skills/news-research/	ヘッドライン、エンティティ、トレンド、ジャーナリスト、出典付きブリーフィング
Monitor Insights	skills/monitor-insights/	モニター、イベント、ニュースレター、Signal Insights の分析

プラグインマニフェストで "skills": "./skills/" を指定してください。提出ポータルの Scan Tools を使ってデプロイ済みの MCP サーバーからスキルをインポートするか、このディレクトリをプラグインパッケージに含めてください。

---

MCP Registry

レジストリ名：io.github.goperigon/perigon-mcp-server。

server.json が信頼できる唯一の情報源です。公開済みのバージョンは変更できません。リスティングを変更した場合は、server.json の version を更新して再公開してください。

---

ローカル開発

このリポジトリでは Bun を使用しています。.dev.vars.example を .dev.vars（Git で無視されます）にコピーし、値を設定してください。

変数	必須	説明
ANTHROPIC_API_KEY	はい	ワーカーの起動に必要です。空でなければどの値でも機能します。実際のキーが必要なのは、プレイグラウンドのチャット（/v1/api/chat）のみです。
PERIGON_API_KEY	プレイグラウンド	手動の API キーを使ってテストする際の、プレイグラウンドのデフォルトキーです。
PERIGON_API_URL	任意	Perigon API のベース URL です。ローカル開発では wrangler.jsonc の値がデフォルトで使用されます。
PERIGON_APP_URL	任意	ディスカバリーメタデータからリンクされる OAuth 同意ページのアプリのベース URL です。
MCP_PUBLIC_URL	任意	OAuth メタデータで使用する公開 MCP オリジンです（デフォルトはローカル開発用 URL）。

開発サーバーは local-mcp.perigon.io にバインドします（vite.config.ts を参照）。このホスト名をマシンで解決できるように、次の行を /etc/hosts に追加してください。

127.0.0.1 local-mcp.perigon.io

bun i
bun dev
bun test

bun dev を実行すると、MCP ワーカーとプレイグラウンドが https://local-mcp.perigon.io:5173 で提供されます。

---

コントリビューションとメンテナー

バグ、不足しているツール、ユースケースについては、GitHub の issue またはプルリクエストを作成してください。Perigon のメンバーが確認します。

セキュリティ上の問題は非公開で報告してください。SECURITY.md をご覧ください。公開 issue は作成しないでください。

Perigon チームがメンテナンスしています。

---

ライセンス

Apache-2.0