コンテンツにスキップ
Documentation

MCPサーバー(AIアシスタントを接続してください)

CHAMPREP はリモートをホストします モデルコンテキストプロトコル (MCP) サーバー。MCP 対応の AI クライアント(Claude(claude.ai および デスクトップ版)、ChatGPT、Claude Code、Codex、Cursor、VS Code、Windsurf など)に 接続すれば、アシスタントが あなたの CHAMPREP アカウント:カレンダーの イベントの一覧表示や予約、メールの閲覧や下書きの作成、ワークボードの管理、ドライブの検索、 請求書、メモ、ドキュメント、スプレッドシートの作成など、これらすべてを 会話形式で行うことができます。

:::注意[エンドポイントの更新: /mcp/v1 を使用してください] エンドポイントは現在 バージョン管理。接続してください https://ai-api.champrep.com/mcp/v1. 以前のバージョン指定のない https://ai-api.champrep.com/mcp は 廃止 — そこへの リクエストは拒否され、切り替えを促すメッセージが表示されます。クライアントが依然として を指定している場合は /mcp、URLを /mcp/v1 (npm-bridge をご利用の方は npx -y @champrep/mcp 次回の実行時に新しいエンドポイントを自動的に取得します)。 :::

最新のクライアントでは、インストールする必要は一切ありません。サーバーは以下のURLでホストされています:

https://ai-api.champrep.com/mcp/v1

アシスタントの推論は AIクライアント お客様のモデルと連携して — CHAMPREP MCP コールは、お客様のクレジットCHAMPREP AIを一切消費しません。すべてのツールコールは お客様自身の ID で実行され、お客様のプラン、 組織のポリシー、および(キーAPIの場合)お客様が選択したスコープの範囲内で制限されます。

接続方法は2つあります。どちらも完全にサポートされていますので、状況に応じてお選びください:

ブラウザでのサインイン(OAuth)API キー
最適なのはAIアプリを対話形式で利用する方スクリプト、CI、サーバー、ヘッドレスツール
設定URLを貼り付け、ブラウザで承認してくださいキーを一度作成し、設定ファイルに貼り付けてください
扱うべき機密情報なし — クライアントの設定にキーが一切反映されません以下の情報を保存してください cpk_… クライアントの設定にキーを入力
アクセス範囲アカウントの全権限(ログインしている状態と同様)以下の スコープ キーを付与します(例:単に calendar:read)
動作環境claude.ai、Claude Desktop、ChatGPT、Claude Code、Codex、Cursor、VS Code、Windsurfブラウザがないクライアントを含め、すべての場合
有効期限セッションは自動的に更新されます。いつでも無効化できます有効期限は任意で設定可能、いつでも無効化できます
取り消し先クライアントで接続を解除するアカウント → APIキー champrep.comにて

経験則: クライアントの前に人が操作している場合は、ブラウザでのサインインをご利用ください。 機械が操作している場合は、必要な処理を実行できる範囲で最も狭いスコープのAPIAPIキーをご利用ください。

オプション A:ブラウザでログインする(推奨)

Section titled “オプション A:ブラウザでログインする(推奨)”

サーバーのURLを以下のように追加してください: キーやヘッダーがない場合。クライアントはサインインフローを CHAMPREP自動的に検出し(動的登録を伴う OAuth 2.1)、 ブラウザで同意CHAMPREPページを開き、承認後に接続します。 そのブラウザCHAMPREPですでにログイン済みの場合は、 承認画面に直接遷移します。複数のアカウントCHAMPREPにログインしている場合は、 接続するアカウントを選択します。

  1. 設定 → コネクタ → カスタムコネクタを追加.
  2. 貼り付け https://ai-api.champrep.com/mcp/v1 その後、保存してください。
  3. ブラウザで同意CHAMPREPページが開きます。内容を確認し、クリックしてください 許可.
  4. 任意のチャットで、ツールメニューからコネクタCHAMPREPを有効にし、次のように尋ねてください: 「未読のCHAMPREPメールがないか確認してください。」

コネクタを利用するには、ChatGPTプランが必要です。 開発者モード (設定 → コネクタ → 詳細設定 → 開発者モード)。

  1. 設定 → コネクタ → 作成 (または コネクタを追加する).
  2. 名前を付けます CHAMPREP、MCPサーバーのURLを https://ai-api.champrep.com/mcp/v1、選択してください OAuth 認証を行い、保存してください。
  3. ブラウザが開いたら、同意CHAMPREPページで承認を行ってください。
Terminal window
claude mcp add --transport http champrep https://ai-api.champrep.com/mcp/v1

その後、以下を実行してください /mcp、選択してください champrep、そして選択してください 認証 — お使いの ブラウザで同意ページが開きます。

設定 → MCP → 新しい MCP サーバーを追加、または以下に追加してください ~/.cursor/mcp.json:

{
"mcpServers": {
"champrep": { "url": "https://ai-api.champrep.com/mcp/v1" }
}
}

Cursor からサーバーの認証が必要であるという通知が表示されたら、サインインの指示に従ってください。

VS Code (GitHub Copilot) および Windsurf

Section titled “VS Code (GitHub Copilot) および Windsurf”

URL を含む HTTP MCP サーバーを追加します https://ai-api.champrep.com/mcp/v1 を クライアントのMCP設定に追加してください。どちらもOAuthフローに対応しており、初回接続時に 同意CHAMPREPページが開きます。

オプション B: API APIキーを使用する

Section titled “オプション B: API APIキーを使用する”

  1. こちらからサインインしてください champrep.com そして開く アカウント → APIキー.
  2. キーを作成し、その スコープ — これらによって、 アシスタントが使用できるツールが決まります。 calendar:read 読み取り専用のカレンダーツールを表示します; calendar:write これにより、イベントを作成または変更するツールも表示されます。アクセス可能な サービスは、必要なものだけに限定してください。
  3. キーをコピーしてください(cpk_live_…)。一度だけ表示されます。

2. クライアントに追加してください

Section titled “2. クライアントに追加してください”

Claudeコード:

Terminal window
claude mcp add --transport http champrep https://ai-api.champrep.com/mcp/v1 \
--header "Authorization: Bearer cpk_live_YOUR_KEY"

Cursor / VS Code / Windsurf (mcp.json(-style 設定):

{
"mcpServers": {
"champrep": {
"url": "https://ai-api.champrep.com/mcp/v1",
"headers": { "Authorization": "Bearer cpk_live_YOUR_KEY" }
}
}
}

Codex CLI (~/.codex/config.toml) — Codexはstdioサーバーと通信するため、 bridgeパッケージをご利用ください:

[mcp_servers.champrep]
command = "npx"
args = ["-y", "@champrep/mcp"]
env = { CHAMPREP_API_KEY = "cpk_live_YOUR_KEY" }

Claude Desktop(stdio設定)およびその他のstdio専用クライアント — @champrep/mcp bridgeは、 ローカルのstdioサーバーをホストされたエンドポイントに転送します:

{
"mcpServers": {
"champrep": {
"command": "npx",
"args": ["-y", "@champrep/mcp"],
"env": { "CHAMPREP_API_KEY": "cpk_live_YOUR_KEY" }
}
}
}

もし CHAMPREP_API_KEY が欠落している場合、ブリッジはサイレントに失敗するのではなく、ブラウザを「API Keys」ページで開き、手順を表示します。

Raw HTTP (独自の統合用 — プレーンな JSON-RPC 2.0)。キーは インラインではなく環境変数から渡すようにしてください。そうすることで、シェルの 履歴に残らないようにできます:

Terminal window
export CHAMPREP_API_KEY="cpk_live_..." # from Account -> API Keys
curl https://ai-api.champrep.com/mcp/v1 \
-H "Authorization: Bearer $CHAMPREP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

MCPクライアントは、ツールの呼び出しについて、確認を求めるかどうか、いつ、どのように確認を求めるかを制御します。 その MCP仕様のユーザーインタラクションに関するガイダンス は、人間の監視と確認プロンプトを推奨していますが、 特定のインタラクションモデルを義務付けてはいません。プロンプトの表示は、クライアントとその設定、 および保存された権限や自動承認ルールなどに依存します。

CHAMPREP は、クライアントが各操作を評価するのに役立つツール注釈を提供します:

  • 読み取り専用ツール (イベントの一覧表示、メールの検索、メモの閲覧…)には readOnlyHint: true.
  • 状態を変更するツール (メールの送信、イベントの作成、ファイルのアップロード…)には readOnlyHint: false.
  • 破壊的なツール have destructiveHint: true およびそのまま 「破壊的アクセス」が有効になっていない限り非表示 破壊的アクセスが有効になっている場合 (次のセクション)。

ツールの注釈は動作を説明するものです。これらは、破壊的なツールであっても、各呼び出しの前に確認ダイアログを表示したり、 プロンプトを表示することを保証するものではありません。変更を許可する前に、 クライアントの承認設定をご確認ください。

以下の機能によって適用される安全対策 CHAMPREP

Section titled “以下の機能によって適用される安全対策 CHAMPREP”

通常の MCP アクションの場合、 は 2 回目の承認CHAMPREPカードを要求するのではなく、 クライアント側の同意処理に依存CHAMPREPしています。サーバーは、 クライアントがプロンプトを表示したかどうかを独自に検証することはありません。

CHAMPREP では、接続制限、適用される API-key スコープ、 サービス認証、組織ポリシー、およびレート制限を引き続き適用します。CHAMPREP’s アクション実行エンジンを経由してルーティングされるアクションも 安全チェックを受け、アカウントの に記録されます。 アクティビティログ、および 元に戻す (対応している場合)。クライアント 側の同意は、サーバー側の拒否や組織が要求する 承認を無効にすることはできません。- CHAMPREP固有の承認を必要とするアクションは、MCP を通じて拒否される場合があります。

破壊的なツールの有効化(オプトイン)

Section titled “破壊的なツールの有効化(オプトイン)”

デフォルトでは、サーバーはデータを永久に削除または消去するツール( ドライブフォルダの削除、ノートの消去、レコードの削除など)を非表示にします。もし 実際にクリーンアップを行う必要があり、アシスタントの助けを借りたい場合は、接続が 破壊的な操作を許可している必要があり、クライアントは以下を追加してそれらを要求する必要があります。 ?destructive=true サーバーのURLに:

https://ai-api.champrep.com/mcp/v1?destructive=true

このURLは、URLが受け入れられる場所ならどこでもご利用いただけます(claude.aiコネクタ、Claude Code、 Cursor、ChatGPTなど)。stdioブリッジの場合は、代わりに環境変数を設定してください:

"env": {
"CHAMPREP_API_KEY": "cpk_live_YOUR_KEY",
"CHAMPREP_ENABLE_DESTRUCTIVE": "true"
}

URLフラグやブリッジ設定だけでは、接続の 権限を上書きすることはできません。読み取り専用の接続、許可されていないサービス、または無効化された 破壊的アクセスがある場合、ツールは依然として利用できません。

アシスタントがこれらのツールを使用して行う操作については、お客様が責任を負うことになります。 削除された データは復元できない場合があります。破壊的なツール APIであっても、サービスの :write スコープ、または該当する場合はその独立した削除スコープ に属しています。それらは依然として destructiveHintですが、 確認プロンプトが表示されるかどうかは、ご利用のクライアントとその設定によって異なります。 前述のサーバー側のチェックおよびアクション監査は、引き続き適用されます。一部の 破壊的なアクションでは、 元に戻す アカウントの「アクティビティ」ページから — ただし、 すべての削除は取り消せないものとして扱われます。

このフラグの設定にかかわらず、一部の機能については 決して MCP を通じて利用可能な機能: 管理操作、コード実行ツール、およびアカウントの削除です。 コード実行に関する規則の唯一の例外は、QA プレビュービルドまたは QA クラウド IDE セッションの開始です。これらはいずれも、承認後に QA の隔離されたサンドボックス内で実行されます (詳細は Code、CI、Runner Farm、およびQA向けのMCP).

ツールはプラットフォーム全体を網羅しており、常に あなた: (Calendarイベント、予約、 空き状況)、 Mail(閲覧、検索、下書き、送信、ラベル、ルール)、 Drive(検索、 ファイル、フォルダ、共有)、 Notes、 Meetings(スケジュール、要約、録音)、 Work (ボード、チケット)、Docs(ドキュメント、コメント、編集提案、バージョン、 エクスポート)、Sheets(ワークブック、範囲、数式、書式設定、検証、 条件付き書式、保護、コメント、バージョン、エクスポート)、Invoices、 Forms、 Contacts、Charts、 CHAMPREP Code、Runner Farm、QA、および Learn。 どのツールが表示されるかは、ご利用のプラン、組織のポリシー、 サービスごとの AI 権限、および(キーAPIの場合)キーのスコープによって異なります。

CodeCHAMPREP(プロジェクト、クローンプラン、パイプライン、ジョブログ、ランナー)、Runner Farm、およびQAについては、以下をご参照ください: Code、CI、Runner Farm、およびQA向けのMCP: アシスタントの機能、プロンプトの例、承認が必要な事項、および Web アプリ内で処理される事項についてご確認ください。

まずは以下の手順をお試しください:

  • 「今週の私のCHAMPREPカレンダーには何が予定されていますか?」
  • 「未読メールはありますか?重要なものはすべて要約してください。」
  • 「今月のPDF契約書をMy Driveから探してください。」
  • 「私のOpsボードに『SSL証明書の更新』というタイトルの作業チケットを作成してください。」
  • 「『Q4計画』という名前のDocsドキュメントを作成し、目標、リスク、 担当者に関するセクションを設けてください。」
  • 「『月次予算』ワークブックで、500を超えるすべての支出をハイライトしてください。」

Browser Relay Bridge(Chrome拡張機能)およびEve AI

Section titled “Browser Relay Bridge(Chrome拡張機能)およびEve AI”

クラウドサービスツールに加え、 CHAMPREP Chrome拡張機能用 ご自身のブラウザをEveに接続できます:

  • 有効にする Eveでこのブラウザを使用する 拡張機能の設定内。
  • Eveは、Web上、デスクトップアプリ内、および Eve AI for VS Code、およびターミナルエージェント(eve / champrep ai) により、アクティブなタブの読み取り、タブの一覧表示、スクリーンショットの取得が可能で、各アクションを承認した後、ナビゲーション、クリック、またはフィールドへの入力を行うことができます。
  • Eveは、メール、銀行、決済、またはログインサイトでは一切動作せず、パスワード、ワンタイムコード、またはカード情報の入力欄には決して文字を入力しません。

  • API キー — キーの閲覧、スコープの確認、有効期限の確認、および無効化については、 [アカウント] → [APIキー]. 無効化は直ちに反映されます。
  • ブラウザでのサインイン — AI クライアント内でコネクタの接続を解除してください。また、 そのブラウザCHAMPREPからサインアウトすることも可能です。そうすれば、そのブラウザに対しては 新しいトークンが発行されなくなります。
  • すべてのエージェントによるアクション アカウントに表示される アクティビティログ 実行内容、実行日時、実行元、および対応している場合は「元に戻す」機能を確認してください。

  • ID 1つあたり、1分間に120回のMCPリクエスト制限があります。より大規模な自動化を行う場合は、 開発者 API サービススコープのキーを使用してください。
  • ツールによる呼び出しは、アカウントの他の部分と同様にプランごとのクォータの対象となります。 アシスタントが実行できる操作は、ご自身で実行できる範囲を超えることはできません。

症状考えられる原因と対処法
クライアントに「認証が必要です」と表示され、何も開かないクライアントが MCP OAuth をサポートしていない可能性があります。API キー(オプション B)を使用してください。キーが取り消された、有効期限が切れた、または入力ミスがある可能性があります。「お使いのクライアントが MCP OAuth をサポートしていない可能性があります。API キーAPI(オプション B)をご利用ください。
Invalid API keyキーが失効、期限切れ、または入力ミスである可能性があります。「アカウント」→「API キー」で新しいキーを作成してください。 [アカウント] → [APIキー].
Unknown or unavailable toolこのツールは、キーのスコープ外にあるか、AI または接続権限によって無効化されているか、あるいは接続権限と ?destructive=true オプトイン。
ツールは確認プロンプトなしで実行されますプロンプトの表示は、MCPクライアントとその承認設定によって制御されます。ツール注釈(を含む)は、 destructiveHint、確認プロンプトが表示されることを保証するものではありません。そのクライアントで保存されている権限と自動承認ルールを確認してください。
書き込みツールが制限メッセージにより拒否されましたCHAMPREPのサーバーサイドの制限(1日あたりの上限、不正利用防止)により拒否されました。メッセージに理由が記載されています。しばらくしてから再試行するか、リクエストの頻度を減らしてください。
同意ページに「セッションが期限切れです」と表示されます承認が長時間放置されていました。クライアント側から接続フローを再実行してください。
ブラウザでのテストでは動作しますが、サーバーやCIからは動作しませんブラウザでのテストでは動作しますが、サーバーやCIからは動作しませんAPIAPIキーを使用してください。ブラウザでのサインインによるトークンの生成は、対話モードでのみ行われます。
429 応答1分あたりの上限に達しました。少し時間を空けてから再試行してください。エンドポイント:本番環境・テスト1分あたりの上限に達しました。しばらく待ってから再試行してください。エンドポイント:本番環境・テスト環境(テスト用キーは )。

エンドポイント: https://ai-api.champrep.com/mcp/v1.