|
### わかりやすいたとえ：学校のパソコン教室
学校のパソコン教室を想像してください：
**ツール MCP（権限を持つ担当者が作成します）**
* パソコン教室にソフトウェアをインストールします
* すべてのパソコンでそのソフトウェアを利用できるように設定します
* ソフトウェアで利用できる機能を決めます
**連絡先の MCP 認証情報**
* 学生ごとに専用のアカウントを作成します
* 各学生は自分のアカウントでログインします
* 学生ごとに異なる利用権限を設定できます
### 実際のワークフロー
```
ステップ 1：MCP ツールを作成します（ツール作成権限を持つ担当者）
↓
「顧客データベース照会」ツールを作成します
- ツールの URL を設定します
- デフォルトの認証情報を設定します（ある場合）
↓
ステップ 2：連絡先ごとに専用の認証情報を設定します（認証情報の設定権限を持つ担当者）
↓
お客様 A：A 専用の認証情報を設定します
お客様 B：B 専用の認証情報を設定します
お客様 C：C 専用の認証情報を設定します
↓
結果：全員が同じツールを使い、それぞれ自分の認証情報を使用します
```
> **柔軟な権限設定**\
> システム管理者は、組織のニーズに応じて、ツールを作成できる人と認証情報を設定できる人を決められます。同じ担当者にすることも、別々に管理することもできます。
### 要点
* **ツール MCP** — まず「ツール」を用意してから利用します
* **連絡先の MCP 認証情報** — 次に一人ひとりに「鍵」を渡します
***
## 6. よくある質問
### Q1：「MCP 認証情報」タブが表示されないのはなぜですか？
**考えられる原因**
* 「連絡先の追加」画面を開いています（先に連絡先を保存し、編集画面に入り直すと表示されます）
* システムに MCP ツールがまだ作成されていません
* 連絡先の情報が保存されていません
**対処方法**
1. 先に連絡先の基本情報を入力して保存してください
2. システムに MCP ツールがあることを確認してください（権限を持つ担当者に確認を依頼してください）
3. 編集モードに入り直してください
***
### Q2：Headers の形式が間違っている場合はどうすればよいですか？
**よくある間違いの例**
* ❌ 誤り：`{'key': 'value'}`（シングルクォートを使っています）
* ❌ 誤り：`{key: value}`（引用符がありません）
* ❌ 誤り：`{"key": "value",}`（末尾に余分なカンマがあります）
* ✅ 正しい形式：`{"key": "value"}`
**対処方法**
1. 「JSON を整形」ボタンをクリックすると、システムが自動的にチェックします
2. まだ問題がある場合は、認証情報をもう一度コピーしてください
3. または、認証情報の提供者に形式の再確認を依頼してください
***
### Q3：何を入力すればよいか、どうすればわかりますか？
**認証情報の入手方法**
1. お客様に認証情報の提供を依頼します
2. 担当者に提供または作成のサポートを依頼します
3. このツールを担当する同僚に確認します
4. 設定に成功している他の連絡先を参考にします（ただし、そのままコピーしないでください！）
**⚠️ 適当な値を入力しないでください**
認証情報には決まった形式と内容があります。入力を間違えるとツールが使えなくなり、データの誤りにつながる可能性もあります。
***
### Q4：「設定済み」ラベルが表示されないのはなぜですか？
**表示条件**
* 緑色のラベルは、認証情報が設定済みのツールにのみ表示されます
* 初めて設定するときは、保存が成功するまで表示されません
* 保存が成功するとラベルが表示されます
**ツール一覧にラベルがまったくありませんか？**
この連絡先にはまだ MCP 認証情報が設定されていないことを意味し、正常な状態です。
***
### Q5：「認証情報をリセット」ボタンが見つからない場合は？
**表示条件（両方を満たす必要があります）**
1. このツールに認証情報が設定されていること（ツール名の右側に緑色の「設定済み」ラベルがあります）
2. 「編集」ボタンをクリックして編集エリアを展開していること
**ボタンの場所**
編集エリアを展開すると、赤い「認証情報をリセット」ボタンが左下に、「キャンセル」と「保存」ボタンが右下に表示されます。
**ツールの認証情報がまだ設定されていませんか？**
リセットする認証情報がないため、「認証情報をリセット」ボタンは表示されません。この場合、左下は空白になります。
***
### Q6：「認証情報をリセット」をクリックするとどうなりますか？
**実行されること**
* この連絡先専用の認証情報が削除されます
* ツール名の右側にある緑色の「設定済み」ラベルが消えます
* ツールにデフォルトの認証情報がある場合は、それを使用するようになります（ただし、通常はありません）
* ⚠️ **削除後は元に戻せません**
**おすすめの対応**
* 先に Headers の内容をコピーしてバックアップしてください
* 本当に削除する必要があるか検討してください
* 内容を変更するだけなら「編集」を使ってください
***
### Q7：複数の連絡先で同じ認証情報を使えますか？
**技術的には可能です**
システムは、同じ認証情報を別の人にコピーすることを制限していません
**ただし、おすすめしません**
* 誰が使用しているかを特定できません
* データが混ざる可能性があります
* 問題が発生した場合、誰の問題かを特定できません
**適切な方法**
* 連絡先ごとに専用の認証情報を使います
* データを明確に分離します
* 追跡と管理をしやすくします
***
### Q8：ツール一覧が空で「利用可能なツールはありません」と表示される場合は？
**考えられる原因**
* システムに MCP ツールがまだ作成されていません
* すべてのツールが「グローバル」タイプです（グローバルツールには個別の認証情報の設定が不要です）
**対処方法**
1. ツール作成権限を持つ担当者に、MCP ツールが作成されているか確認を依頼してください
2. ツールのタイプが正しく設定されていることを確認してください
3. すべて正常でも表示されない場合は、テクニカルサポートにお問い合わせください
***
## 付録：操作チェックリスト
### 設定前の確認
* [ ] 連絡先が作成され、保存されていること
* [ ] システムに利用可能な MCP ツールがあること
* [ ] 認証情報を入手していること（お客様または担当者から）
* [ ] 認証情報の形式が正しいこと
### 設定中の確認
* [ ] Headers の形式が正しいこと（整形ボタンでチェックできます）
* [ ] 必要なフィールドがすべて入力されていること
* [ ] 余分な内容や誤った内容がないこと
* [ ] 整形後にエラーメッセージが表示されないこと
### 設定後の確認
* [ ] ツール名の右側に緑色の「設定済み」ラベルが表示されていること
* [ ] 実際にテストし、ツールが正常に動作すること
* [ ] 設定情報を記録したこと（日付、連絡先、ツール名）
* [ ] 必要に応じて、関係者に設定完了を通知したこと
---
# 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.maiagent.ai/maiagent-user-guide/ja/build/tools/setup-contacts-mcp-credentials.md?ask=&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.
.png?alt=media)