Mencoro

Mencoro MCP サーバー

AI アシスタントに、AI の回答におけるブランドの状況（ランキング、言及、センチメント、Share of Voice）を尋ね、平易な言葉でモニタリングを設定・調整できます。

Mencoro は、ChatGPT、Perplexity、Google AI Overview、AI Mode などの AI 回答エンジンと、Google 検索およびショッピングで、ブランドがどのように表示されるかを追跡します。MCP サーバーは、そのデータをあらゆる MCP クライアントに公開し、プロジェクト、追跡対象のクエリ、クラスター、組織を管理できるようにします。ツールは66 個（読み取り専用が31個、変更を加えるものが35個）、プロンプトは20 個あります。そのうちの1つである get_mencoro_guide は、Mencoro 自体に関する質問に答えるもので、サインインせずに利用できます。

このサーバーはホスト型です。ほとんどのクライアントは、サーバーに直接接続してください。

https://api.mencoro.com/mcp

このリポジトリには、サーバーの公開メタデータと、ローカルプロセスしか起動できないホスト向けの小規模な stdio ブリッジ（@mencoro/mcp）が含まれています。Mencoro アプリケーションのソースは含まれていません。

接続

リモート MCP に対応しているクライアント（推奨）

インストールもローカルプロセスも不要です。OAuth でサインインするか、パーソナルアクセストークンをヘッダーに貼り付けます。

ローカルプロセスしか起動できないクライアント

Claude Desktop の手動設定や、stdio のみをサポートする古いホストでは、ブリッジが必要です。このパッケージがその役割を果たします。

npx -y @mencoro/mcp

// claude_desktop_config.json
{
  "mcpServers": {
    "mencoro": {
      "command": "npx",
      "args": ["-y", "@mencoro/mcp"],
      "env": { "MENCORO_API_KEY": "mcp_pat_your_token" }
    }
  }
}

トークンは引数ではなく環境変数を通じて渡すため、ps の出力に表示されず、ホストによる引数分割の影響も受けません。

認証

接続方法は2つあります。どちらも同じ3つの権限を持ち、組織での自分のロールで許可されている範囲を超える操作はできません。

OAuth 2.1 — ワンクリックで接続できます。Claude、ChatGPT、Claude Code、およびMCP認可仕様に対応するすべてのクライアントでサポートされています。コピーや貼り付けは不要で、アプリから取り消せます。 同意画面では、クライアントが要求したスコープがあらかじめ選択されています（何も要求していない場合は3つすべてが選択されます）。ただし、read以外は選択を解除できます。 サーバーはPKCE（S256）、Client ID Metadata Documents、Dynamic Client Registration、RFC 9728リソースメタデータを通知するため、クライアントは必要な情報をすべてhttps://api.mencoro.com/.well-known/oauth-protected-resource/mcpから取得できます。接続に必要なスコープがない状態でツールを呼び出すと、要求すべきスコープを示す403 insufficient_scopeが返されます。そのため、段階的な認可に対応しているクライアントでは、追加の権限を付与して再接続するよう求められます。

個人用アクセストークン — CLIクライアント、設定ファイル、このブリッジで使用します。tool.mencoro.com/me/mcp-serverで作成してください。トークンは一度だけ表示され、mcp_pat_で始まります。選択した権限（デフォルトでは3つすべて）が付与され、1つの組織に固定したり、有効期限を設定したりできます。Authorization: Bearer mcp_pat_…として送信してください。トークンに必要な権限がない状態で呼び出すと、その権限を示すツールエラーが返されます。トークンの権限は後から追加できないため、権限を追加するには新しいトークンを作成してください。

書き込みアクセスが導入される前に作成された接続とトークンには、organization:manageはなく、readとwriteが付与されています。

ChatGPTはリモートコネクターにカスタムのAuthorizationヘッダーを送信できないため、そこで使う場合はOAuthを使用してください。

クライアント設定

{
  "mcpServers": {
    "mencoro": {
      "url": "https://api.mencoro.com/mcp",
      "headers": { "Authorization": "Bearer mcp_pat_your_token" }
    }
  }
}

{
  "servers": {
    "mencoro": {
      "type": "http",
      "url": "https://api.mencoro.com/mcp",
      "headers": { "Authorization": "Bearer mcp_pat_your_token" }
    }
  }
}

[mcp_servers.mencoro]
url = "https://api.mencoro.com/mcp"
http_headers = { "Authorization" = "Bearer mcp_pat_your_token" }

{
  "mcpServers": {
    "mencoro": {
      "httpUrl": "https://api.mencoro.com/mcp",
      "headers": { "Authorization": "Bearer mcp_pat_your_token" }
    }
  }
}

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mencoro": {
      "type": "remote",
      "url": "https://api.mencoro.com/mcp",
      "enabled": true,
      "headers": { "Authorization": "Bearer mcp_pat_your_token" },
      "oauth": false
    }
  }
}

{
  "mcpServers": {
    "mencoro": {
      "serverUrl": "https://api.mencoro.com/mcp",
      "headers": { "Authorization": "Bearer mcp_pat_your_token" }
    }
  }
}

{
  "mcpServers": {
    "mencoro": {
      "type": "http",
      "url": "https://api.mencoro.com/mcp",
      "headers": { "Authorization": "Bearer ${MENCORO_API_KEY}" }
    }
  }
}

ツール

読み取り専用ツールは31個、何らかの変更を行うツールは35個あります。各ツールは、4つすべてのMCPアノテーション（readOnlyHint、destructiveHint、idempotentHint、openWorldHint）を明示的に宣言しているため、クライアントはツールを呼び出す前に何を確認するか判断できます。

読み取り

すべての読み取りツールには read スコープのみが必要です。

変更

C が付いたツールには確認が必要です。ツール名と引数を指定して preview_operation を呼び出し、計画をユーザーに提示してください。ユーザーが同意した後に限り、返された confirmationToken を使ってツールを呼び出してください。トークンは一度しか使用できず、数分後に期限切れになります。また、計画に記載された内容に変更があった場合は拒否されます。作成ツール、ジョブ開始ツール、確認が必要なツールは requestId も受け付けます。同じ ID で再試行すると、処理を二重に実行せず、最初の結果を返します。

変更は、Mencoro アプリで拒否される条件とまったく同じ場合に拒否されます。たとえば、組織でのあなたのロール、プロジェクトがアーカイブ済みであること、アプリで必要とされるサブスクリプションがないことなどです。 日付は ISO 形式の YYYY-MM-DD で、保持期間内でなければなりません。順位は 1 始まりで、小さいほど良い値です。それ以外の指標は、値が大きいほど改善を示します。

最新の定義（名前、説明、入力・出力スキーマ、注釈）は、認証情報なしで https://api.mencoro.com/public/v1/mcp から確認できます。これは、initialize、 ping、tools/list、prompts/list と公開ガイド（get_mencoro_guide）に応答し、 それ以外のすべてを拒否する、同じサーバー上の検出専用マウントです。 その他のツールを呼び出すには、https://api.mencoro.com/mcp でサインインする必要があります。

プロンプト

MCP プロンプトに対応するクライアントで利用できる、すぐに使える 20 個の出発点です。そのうち 12 個はデータについて質問します。

brand_ai_overview · whats_changed · organization_overview · top_queries · biggest_movers · query_history · competitor_standing · head_to_head · negative_mentions · cited_sources · coverage_health · sov_explainer

4 個は、重要な箇所で承認を求めながら、変更の手順を段階的に進めます。

4 個はデータを意思決定に役立てます。

ChatGPT への申請とスキル

chatgpt-app-submission.json には、アプリの申請メタデータ、 ツールのアノテーションに関する根拠、レビュー用テストケースが含まれています。機能が変わった場合は、 ツールの説明と根拠をホストされているサーバーに合わせてください。

10 個の任意のスキルにより、ツールを再利用可能なワークフローとして活用できます。ChatGPT では MCP プロンプトが表示されないため、 これらのスキルによって、ユーザーは同じようにガイド付きのフローを利用できます。

6 個は分析のみを行い、変更は一切加えません。

• Visibility report：パフォーマンスの概要、傾向、クエリの増減を表示します。
• Competitor analysis：シェア・オブ・ボイスと競合との直接比較を行います。
• Sentiment review：言及箇所の引用を出典付きで示し、センチメントの内訳を表示します。
• Coverage audit：現在のモニタリング対象と古くなったクエリを確認します。
• Results review：変更によって AI 上の可視性が向上したかどうかを、ベースラインと比較して変更前後で確認します。
• Optimization insights：改善すべき項目を優先順位付きで提示します。接続済みの Ahrefs、Semrush、Search Console、Google Analytics のツールを利用することもできます。

4 個は変更を加えますが、ユーザーの承認後に限り、write スコープが必要です。

• Project setup：ウェブサイトを基に、短いやり取りでモニタリング対象のプロジェクトを作成します。作成前に、ブランド名と競合候補を提示します。
• Query expansion：追跡する価値のある新しいプロンプトやキーワードを、ユーザーが選んだものから追加します。
• Cluster reorganisation：クラスタリング案を提示し、確認後に適用します。
• Cost tuning：頻度、パス、休止の設定を変更し、チェックにかかる費用をプランの範囲内に収めます。

申請ポータルの Skills ステップで、skills/ 内の各スキルフォルダー、またはそのフォルダーを含む ZIP をアップロードしてください。SKILL.md と agents/openai.yaml の両方を含めてください。後者には、既存の Mencoro MCP 接続が宣言されています。ユーザーは OAuth 経由で Mencoro アカウントに接続する必要があります。 これらのスキルに追加のバックエンドエンドポイントやローカル実行ファイルは必要ありません。

ポータルにはアップロード時のスナップショットが保存されます。指示を変更した場合は、更新したバンドルをアップロードしてください。また、アプリを申請する前に、アカウントを接続した状態で各ワークフローをテストしてください。OpenAI skills guide を参照してください。

ブリッジ

実行する

export MENCORO_API_KEY=mcp_pat_your_token
npx -y @mencoro/mcp            # serve on stdio
npx -y @mencoro/mcp doctor     # check the endpoint, the token, and list the tools

Docker

docker run --rm -i -e MENCORO_API_KEY=mcp_pat_your_token ghcr.io/mencoro/mencoro-mcp

-i は必須で、-t は省略してください。MCP トランスポートはこのプロセスの標準入力と標準出力です。

オプション

実際の動作

クライアントの標準入出力トランスポートを Streamable HTTP トランスポートに接続し、すべての JSON-RPC フレームを双方向にそのまま転送します。内部を確認するのはハンドシェイクだけです。これにより、ネゴシエートされたプロトコルのバージョンを上流にそのまま返し、サーバーからセッションが破棄された場合に再構築できます。デプロイやスケールダウンによってセッションが破棄されることがあります。 それ以外のメソッドは認識しないため、サーバーとのずれは生じません。ツール、プロンプト、リソース、補完、進行状況の通知、そして 後から追加されたものも、すべてそのまま通過します。

認証情報がない場合

ブリッジはそのまま起動し、ホストされているサーバーが公開している内容をコミットしたコピーであるcatalog.jsonと、mencoro_setupツールを提供します。そのため、npx -y @mencoro/mcpを調べると、認証情報を使って実行した場合と同じツールとプロンプトが確認でき、パッケージをスキャンするものにも、空に見えるサーバーではなく実際のカタログが表示されます。これらのツールのいずれかを呼び出すと、エラーとしてセットアップ手順が返されます。作り出したデータが返されることはありません。例外はget_mencoro_guideです。これは公開済みの資料のみを読み取り、ブリッジがホストされているサーバーの匿名エンドポイントに転送して、実際の回答を返します。

npm run sync:catalogは匿名カタログエンドポイントからファイルを更新し、npm run check:catalogはコミット済みのコピーが古くなっている場合に失敗します。ミラー元のカタログは別のリポジトリにあり、このリポジトリのプルリクエストでは変更を検出できないため、週次でチェックを実行するスケジュール済みワークフローを用意しています。

制限事項

リポジトリの内容

開発

npm ci
npm run typecheck
npm test            # builds first, then runs the suite
npm run check:manifests
npm run check:catalog   # asks the hosted server whether catalog.json is still current

テストではNodeの型ストリッピングを使ってTypeScriptソースを直接実行するため、開発にはNode 22.18以降が必要です。公開パッケージの対象はNode 20.19以降で、CIではビルド済みアーティファクトに対して別途検証されます。

リリースはタグを付けて作成します。npm version <patch|minor|major>を実行し、新しいバージョンをserver.json（.version、npmパッケージのエントリー、イメージタグ）にも反映してから、npm run check:manifestsを実行し、タグをプッシュします。その後、CIがnpm、GHCR、MCPレジストリの順に公開し、続いてGitHubリリースを作成します。GlamaはこのGitHubリリースを基に新しいバージョンをビルドします。

サポート

• 製品やアカウントに関するお問い合わせ — [email protected]
• このパッケージのバグ — issueを作成
• セキュリティ — SECURITY.mdを参照してください
• サーバーについて — mencoro.com/features/mcp-server
• プライバシーポリシー — mencoro.com/legal/#privacy
• 利用規約 — mencoro.com/legal/#terms

ライセンス

MIT。LICENSEを参照してください。

assets/に含まれるMencoroの名称、ロゴ、ブランド素材はMencoroの商標であり、このライセンスの対象ではありません。