Orphex MCPサーバー
コミット 2026年11月14日Google Ads、Meta、TikTok、その他のプラットフォームにわたる広告パフォーマンスを分析し、承認されたキャンペーン変更をAIアシスタントを通じて実行します。
別名 OrphexTech/orphex-agent-plugin, orphex-agent-plugin
- スター
- 1
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 1.0.1
- 最終コミット
- 2026年11月14日
- ライセンス
- Apache-2.0
Orphex MCPとは
OrphexはMCPサーバーです。 Google Ads、Meta、TikTok、その他のプラットフォームにわたる広告パフォーマンスを分析し、承認されたキャンペーン変更をAIアシスタントを通じて実行します。.
プロジェクトのREADMEから生成された概要
Orphex MCP server について
Orphexは、マーケティング担当者がAIアシスタントを通じて広告パフォーマンスの分析やキャンペーン管理を行えるようにします。このリモートMCP serverは、Google Ads、Meta、TikTok、LinkedIn、Shopifyを含む20以上のプラットフォームに接続し、自然言語を使用して広告費、ROAS、コンバージョンデータを照会できます。OAuthを介してリモートエンドポイントに接続するため、Claude、Cursor、Gemini CLIなどのさまざまなAIクライアントで動作し、セットアップ時に手動でAPIキーを入力する必要はありません。
ユーザーは、詳細なパフォーマンス分析、月次のエグゼクティブサマリーの生成、キャンペーンのペース配分や異常のモニタリングを行うことができます。データの読み取りだけでなく、予算の調整、広告の停止、除外キーワードの追加といったキャンペーン変更の実行もサポートしています。セキュリティを確保するため、システムは承認優先のワークフローを採用しています。実際の運用アカウントに対してアクションが実行される前に、AIが提案された変更のプレビューを提示し、ユーザーの明示的な同意を得る仕組みになっています。
できること
- 1パフォーマンス変動の分析CPAやROASなどの特定の指標が2つの期間の間でなぜ変化したのか、アシスタントに説明を求めます。
- 2マーケティングレポートの自動生成ステークホルダー向けの要約を含む、包括的な月次パフォーマンスレポートをリクエストします。
- 3制御されたキャンペーン更新の実行安全なプレビューと承認プロセスを通じて、キャンペーンの予算やステータスを変更します。
- 4プラットフォームの稼働状況のモニタリング現在どのキャンペーンがアクティブであるか、および割り当てられた予算に関するリアルタイム情報を取得します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Orphex MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにOrphex MCPをインストール
$ claude mcp add --transport http orphex-agent-plugin https://api.orphex.co/api/interaction-gateway/v1/mcpCursorにOrphex MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"orphex-agent-plugin": {
"url": "https://api.orphex.co/api/interaction-gateway/v1/mcp"
}
}
}VS CodeにOrphex MCPをインストール
.vscode/mcp.json
{
"servers": {
"orphex-agent-plugin": {
"type": "http",
"url": "https://api.orphex.co/api/interaction-gateway/v1/mcp"
}
}
}VS Code CLIにOrphex MCPをインストール
$ code --add-mcp '{"name":"orphex-agent-plugin","type":"http","url":"https://api.orphex.co/api/interaction-gateway/v1/mcp"}'CodexにOrphex MCPをインストール
$ codex mcp add orphex-agent-plugin --url https://api.orphex.co/api/interaction-gateway/v1/mcpCodex config.tomlにOrphex MCPをインストール
~/.codex/config.toml
[mcp_servers.orphex-agent-plugin] url = "https://api.orphex.co/api/interaction-gateway/v1/mcp"
Gemini CLIにOrphex MCPをインストール
$ gemini mcp add -s user --transport http orphex-agent-plugin https://api.orphex.co/api/interaction-gateway/v1/mcpGemini settings.jsonにOrphex MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"orphex-agent-plugin": {
"url": "https://api.orphex.co/api/interaction-gateway/v1/mcp",
"type": "http"
}
}
}自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能orphextech/orphex-agent-plugin is public and reachablegithub.com/orphextech/orphex-agent-plugin ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-13github.com/orphextech/orphex-agent-plugin ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答HTTPS endpoint answered 401 (sign-in required)合格
README
GitHubで見るOrphex MCP
Ask your AI assistant about your ad accounts — spend, ROAS and campaigns across Google Ads, Meta, TikTok and 20+ more platforms — and make changes only after you approve them.
Remote MCP server and plugin for Claude, ChatGPT, Cursor, Gemini CLI and other AI assistants.
Quick start · What you can do · Manual setup · Security
Quick start
You need an Orphex account with at least one workspace. Every client signs you in with that account on the Orphex sign-in page, in your browser; there is no API key to paste.
| Client | Get started |
|---|---|
| Claude Code | Run /plugin marketplace add OrphexTech/orphex-agent-plugin, then /plugin install orphex@orphex. Details |
| Claude apps | Connect Orphex in claude.ai or Claude Desktop with the Claude setup steps. Details |
| Cursor | Add Orphex to Cursor in one click, then sign in. Details |
| Gemini CLI | Run gemini extensions install https://github.com/OrphexTech/orphex-agent-plugin, then /mcp auth orphex. Details |
| Codex and ChatGPT | Install from OpenAI's plugin directory once Orphex is listed there. Details |
| Other MCP clients | Add the remote MCP URL and sign in. Manual setup |
Try this first:
Using Orphex, how did our spend and ROAS change last week compared with the week before, platform by platform, and what drove the biggest change?
What you can do
Ask in your own words; the plugin's skills pick the prepared method, report template or live read that fits the question.
| Capability | Try asking |
|---|---|
| Performance analysis | "Why did our CPA on Google Ads go up last week compared with the week before?" |
| Reports | "Build the monthly performance report for October, with an executive summary." |
| Live platform reads | "Which of our Meta campaigns are active right now, and what budget is each one on?" |
| Change history | "What changed in our Google Ads account this week, and who made each change?" |
| Approval-first changes | "Pause the 'Black Friday Prospecting' campaign on Meta, and show me the preview before you apply it." |
| Pacing and anomalies | "Are any campaigns pacing to overspend this month, or showing an unusual drop in conversions?" |
Platforms: Google Ads, Meta, TikTok, LinkedIn, Pinterest, Snapchat, X Ads, Apple Ads, Google Analytics 4, Shopify, AppsFlyer, Adjust and more than a dozen other ad, analytics and commerce platforms. Which of them a workspace reaches depends on what it has connected in Orphex.
Manual MCP setup
Orphex is a remote MCP server. In an MCP client that takes a server URL, add this one as a Streamable HTTP server and sign in with your Orphex account when the client asks:
https://api.orphex.co/api/interaction-gateway/v1/mcp
Sign-in uses OAuth in your browser, never an API key. Orphex admits a known list of clients and does not accept dynamic client registration, so if your client cannot complete sign-in, write to support@orphex.co.
Claude Code
Add this repository as a plugin marketplace, then install the plugin from it:
/plugin marketplace add OrphexTech/orphex-agent-plugin
/plugin install orphex@orphex
The first Orphex call opens your browser on the Orphex sign-in page. Claude Code receives
the sign-in on port 33418 of your machine, so that port has to be free while you sign
in. To pick up a newer release later, run /plugin marketplace update orphex.
Claude apps
In claude.ai or Claude Desktop, connect Orphex by following the Claude setup steps at
https://mcp.orphex.co/support.
To upload the plugin to a Claude app, use the orphex-vX.Y.Z.zip attached to the
latest release.
Cursor
Add Orphex to Cursor
opens Cursor and offers to install the Orphex connection; the first call opens your browser
on the Orphex sign-in page. The same link as a Cursor deeplink is
cursor://anysphere.cursor-deeplink/mcp/install?name=orphex&config=eyJ1cmwiOiJodHRwczovL2FwaS5vcnBoZXguY28vYXBpL2ludGVyYWN0aW9uLWdhdGV3YXkvdjEvbWNwIn0=.
This repository is also laid out as a Cursor plugin, with its manifest in
.cursor-plugin/plugin.json, so Cursor reads the four skills from it as well.
Gemini CLI
Install this repository as a Gemini CLI extension, restart Gemini CLI, and sign in from inside it:
gemini extensions install https://github.com/OrphexTech/orphex-agent-plugin
/mcp auth orphex
The extension names Orphex's public sign-in client itself, so your settings.json needs no
edit. The browser opens on the Orphex sign-in page, and Gemini CLI receives the sign-in on
port 7777 of your machine, so that port has to be free while you sign in. The extension loads
the four skills too.
Codex and ChatGPT
OpenAI's plugin directory is shared by ChatGPT and Codex. Once Orphex is listed there,
install it in Codex CLI by running codex and then /plugins, and in ChatGPT from the same
directory. The OpenAI build of this plugin is on this repository's openai branch.
What the plugin contains
Orphex is an advertising-analytics platform. This plugin teaches Claude how to work with an Orphex connection: how to find the right capability before calling it, how to address a workspace, how to read the metric vocabulary before the numbers, and which prepared method answers a question about spend, ROAS, conversions, pacing or anomalies across the ad, analytics and commerce platforms a workspace has connected. It also carries the approval-first flow for making a change you ask for, such as a budget, a bid or a campaign's status: Claude shows you a preview, waits for your approval, and only then makes the change.
- Four skills, written as plain Markdown instructions:
orphex-actions— makes a change you ask for, such as pausing or enabling a campaign, changing a budget or a bid, creating a campaign, ad set or ad, adding negative keywords, uploading media, changing Tag Manager, GA4, Singular or Insider catalog settings, or undoing an earlier change, through the approval-first flow described below.orphex-analyst— answers questions about what the numbers are, why they moved and what to do about it, and routes each one to the prepared method that fits.orphex-platform-reads— routes a question that names one advertising platform to the guide for that platform's own live reads.orphex-reporting— builds a report, such as a weekly or monthly performance report, an executive summary or an account review, by filling one of the report templates the workspace can use.
- One remote MCP server entry,
orphex.
It contains no hooks, commands, agents, scripts or executables, installs no packages, and runs no code on your machine.
These skills work through the Orphex connection. For portable marketing-analysis skills that work from exports you supply and use an Orphex connection when one is present, see Orphex Agent Skills.
Example prompts
Replace the names below with your own campaigns and workspaces. Each one names the skill that handles it.
- "Why did our ROAS on Meta drop last week compared with the week before?" — an
analysis, answered with the
orphex-analystmethod from read-only calls. - "Build the monthly performance report for September." — a report, built by
orphex-reporting, which starts from a prepared report template when the workspace has one. - "Which of our TikTok campaigns are active right now, and what budget is each one
on?" — a live read from the platform itself, routed by
orphex-platform-readsto the TikTok guide. - "Who paused my Google Ads campaigns this week?" — a read of what changed, combining
the platform's own change log with changes made through Orphex, routed by
orphex-analyst. - "Raise the daily budget of the 'Summer Sale' Meta campaign from 100 to 120, and show
me the change before you apply it." — a change, made by
orphex-actions: Claude shows the before-and-after preview and applies it only after you approve.
Security
How changes are made
Answering questions and building reports use read-only calls. A change happens only when
you ask for one, and the orphex-actions skill tells Claude to take the same steps every
time:
- Propose. Claude finds the change on the Orphex server, reads its procedure there and proposes it. For most changes the proposal changes nothing: the server answers with a preview of the item, its current value and the proposed one, and the result of its safety checks.
- Your decision. Claude shows you the preview and waits for your answer. The skill tells Claude to go ahead only on your approval and never to approve on your behalf.
- Change. Only after you approve does Claude confirm the change, with a one-time token bound to the preview you saw, so what runs is what you approved. The token expires about 15 minutes after the proposal.
- Outcome. Claude reads the result back from the change request's own status and tells you what happened, including any part that did not go through.
A few changes run in a single call with no separate preview; for those the skill tells Claude to describe what the call will do and to make it only after you say yes. Undoing a change is a new proposal that goes through the same preview and approval.
Changes go only through the Orphex endpoint below, and only where Orphex allows them: your Orphex plan has to include changes, the workspace has to have them switched on (they stay off until a workspace admin enables them), and your Orphex account needs an editor role in that workspace. Orphex's safety checks can refuse a change, for example a budget step larger than one change may take, and some workspaces require a recorded approval, sometimes from a second person, before a change can run. Where changes are not available, Claude tells you what the server says and changes nothing.
What it connects to
The plugin connects to exactly one endpoint, over HTTPS:
https://api.orphex.co/api/interaction-gateway/v1/mcp.
Sign-in uses OAuth through Orphex's Auth0 tenant at https://auth.orphex.co/: your
browser opens the Orphex sign-in page and you log in with your own Orphex account. The
plugin carries no password, API key or client secret.
What data is sent
The requests Claude makes on your behalf — which capability to run, the workspace, and arguments such as dates and metrics — go only to the Orphex endpoint above, and the results come back from it. Access is limited to the workspaces your Orphex account can already see. The plugin itself collects nothing, stores nothing and sends no telemetry.
Privacy
Orphex's privacy policy is at https://orphex.co/en/privacy-policy.
Requirements
An Orphex account with at least one workspace. Accounts and platform connections are managed at mcp.orphex.co.
Support
Questions and problems: support@orphex.co.
About this repository
This repository is published from Orphex's own source by a release workflow, so changes are not made here and pull requests are not merged. Send problems and suggestions to the support address above.
License
Copyright 2026 Orphex. Licensed under the Apache License, Version 2.0; see LICENSE.
Orphex MCPのよくある質問
Orphex MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http orphex-agent-plugin https://api.orphex.co/api/interaction-gateway/v1/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Orphex MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Orphexを使用して広告キャンペーンの変更を行うにはどうすればよいですか?
変更は承認優先のフローで行われます。AIが変更案を提示してプレビューを表示し、ユーザーが明示的に承認した場合にのみ実行されます。
OrphexのセットアップにAPIキーは必要ですか?
いいえ、Orphexはブラウザ経由のOAuthサインインを使用するため、APIキーを貼り付ける必要はありません。
Orphexはどの広告プラットフォームをサポートしていますか?
Google Ads、Meta、TikTok、LinkedIn、Pinterest、Snapchat、X Ads、Apple Adsに加え、Google Analytics 4やShopifyなど多くのプラットフォームをサポートしています。