> For the complete documentation index, see [llms.txt](https://docs.immedio.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.immedio.io/mcp/readme.md).

# MCPサーバー

AIアシスタントからimmedioのデータを参照・操作できるMCPサーバーのヘルプです。Claude DesktopやChatGPTなどから接続してご利用いただけます。

## MCPサーバーとは

MCP (Model Context Protocol) は、AIアシスタントが外部システムの情報や機能を扱うための標準プロトコルです。immedio MCPサーバーは、immedio・immedio Boxを横断して扱えるサーバーです。Claude DesktopやChatGPTなどのAIアシスタントから、お客様自身のimmedio上のデータを直接参照・操作できます。

## MCPサーバーでできること

| やりたいこと              | 説明                                                |
| ------------------- | ------------------------------------------------- |
| 業務システム上の情報をAIに参照させる | 日程調整URLやコンテンツの状況などを会話で取り出します                      |
| 業務状況を会話で整理させる       | 「先週の面談を一覧で」「acme.co.jp 社の閲覧状況をまとめて」のような問い合わせに答えます |
| 操作を会話で完結させる         | URLの発行や設定の参照をAIから依頼します。最終承認はユーザーです                |
| 他システムと組み合わせる        | 別のMCPサーバー(社内ナレッジ、カレンダー等)と併用して、文脈横断のアシスタントを構築できます  |

## 機能別ガイド

MCPサーバーで利用できる機能の詳細は、機能ごとのページで説明しています。各ページでは、ユースケース・依頼の仕方・取得できるデータの例を紹介しています。

### immedio

| 機能                                                 | 説明                                          |
| -------------------------------------------------- | ------------------------------------------- |
| [面談一覧・詳細ツール](/mcp/immedio/meetings.md)             | 面談の一覧と、面談メモ・面談前アンケートの回答などの詳細を確認します          |
| [リード一覧ツール](/mcp/immedio/leads.md)                  | ステータスや流入元でリードを絞り込み、フォローすべきリードを特定します         |
| [日程調整URL検索ツール](/mcp/immedio/date-select-urls.md)   | 日程調整URLを検索し、候補日程の期間やフォームの事前入力値を追加したURLを作ります |
| [面談タイプ一覧ツール](/mcp/immedio/reservation-settings.md) | 面談タイプの会議手段・面談時間・予約画面・最終予約日時を確認します           |
| [グループ・ユーザー一覧ツール](/mcp/immedio/users-groups.md)     | グループのユニット構成と、ユーザーの所属を確認します                  |

### immedio Box

| 機能                                                 | 説明                                    |
| -------------------------------------------------- | ------------------------------------- |
| [テナント・資料の確認](/mcp/immedio-box/contents.md)         | 所属しているテナントと、テナント内の資料を確認します            |
| [トラッキングリンクの発行](/mcp/immedio-box/tracking-links.md) | 資料と送付先のメールアドレスを指定して、トラッキングリンクを発行します   |
| [ホットリードの確認](/mcp/immedio-box/hot-leads.md)         | 直近1時間・1日・1週間に資料へアクセスしたリードを確認します       |
| [会社の閲覧状況の確認](/mcp/immedio-box/company-overview.md) | 会社情報と、その会社で直近に資料を閲覧したリードを確認します        |
| [リードの閲覧状況の確認](/mcp/immedio-box/lead-activity.md)   | リードの閲覧履歴と、資料ごとのページ別滞在時間やアンケート回答を確認します |

## 接続方法

すべてのクライアント共通の接続URLは次のとおりです。

```
https://mcp.immedio.io/mcp
```

### Claude Desktop

1. Claude Desktopの「カスタマイズ」→「コネクタ」を開きます
2. 「カスタムコネクタを追加」をクリックすると、モーダルが開きます
3. 名前に「immedio」、リモートMCPサーバーURLに「<https://mcp.immedio.io/mcp」を入力します>
4. ブラウザでimmedioログインと同意画面が開きます。承認すると接続完了です

### ChatGPT

ChatGPT Plus / Team / Enterpriseで利用できます。

1. ChatGPTの「設定」→「アプリ」→「高度な設定」を開きます
2. 「開発者モード」をオンにすると、「アプリを作成する」が押せるようになります
3. 名前に「immedio」、「接続」のURL欄に「<https://mcp.immedio.io/mcp」を入力します>
4. ブラウザでimmedioログインと同意画面が開きます。承認すると接続完了です

### Claude Code

エンジニア向けに、ターミナルから次のコマンドで追加できます。

```
claude mcp add --transport http immedio https://mcp.immedio.io/mcp
```

### その他のMCP対応クライアント

Cursorなど他のMCP HTTP対応クライアントでも、同一の接続URLを設定すれば利用できます。

## 認証・権限

接続時はブラウザでimmedioへログインします。表示される同意画面から接続を承認します。

* 同意画面では「どのクライアントが接続しようとしているか」を確認できます
* 操作できる範囲は、ログインしたユーザーがimmedio上でできる範囲と同じです
* セッションが切れたら、同じ手順で再度認証します

## セキュリティ

MCPサーバーを安全に利用していただくため、以下の点にご注意ください。

### 公式エンドポイントのみを使う

immedio MCPサーバーの公式エンドポイントは次の1つだけです。

```
https://mcp.immedio.io/mcp
```

これ以外のURLを案内された場合、フィッシングの可能性があります。接続しないでください。

### 信頼できるクライアントだけを使う

MCP対応クライアントの中には、出所不明のものや改変版も存在します。Claude DesktopやChatGPTのような公式アプリ、もしくは社内で承認されたクライアントだけをご利用ください。

### プロンプトインジェクションのリスク

信頼できないツールやエージェントとimmedio MCPサーバーを組み合わせると、ツール経由でAIへ悪意ある指示が混入する恐れもあります。

お客様のデータが外部へ持ち出されるリスクもあるため、併用するクライアントの構成にはご注意ください。

### AIの最終承認はユーザー

AIが提案した操作 (URLの発行、設定の更新など) は、実行前にユーザー自身で内容を確認することを推奨します。AIへ任せきりにせず、各操作の最終判断はご自身で行ってください。

## よくある質問

### Q. どのクライアントから利用できますか

Claude Desktop・ChatGPT・Claude Codeで動作確認済みです。Cursorなど他のMCP HTTP対応クライアントでも、同一のエンドポイントを設定すれば利用できます。

### Q. アクセストークンはどこに保存されますか

ログイン後のアクセストークンは、接続したクライアントのローカルに保存されます。

immedio側でセッション管理用の最小限の情報のみ保持し、トークンを共有することはありません。

### Q. AIが勝手にimmedioを操作してしまいませんか

操作系のツール (URL発行や設定変更など) はユーザー承認の組み込みを推奨します。

AIの提案した操作の最終判断は、ユーザー自身で行ってください。

### Q. 利用できる権限の範囲はどう決まりますか

ログイン中のユーザー権限と同等の範囲です。

チーム管理者と一般メンバーで操作可能な範囲は異なります。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.immedio.io/mcp/readme.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.