Search the alley

記事を検索

2文字以上でタイトル・カテゴリ・タグを検索できます。

MCPとは?AIエージェントに外部ツールをつなぐ仕組みと注意点

MCPとは何か、AIエージェントと外部ツール・データソースをつなぐ仕組み、CodexやClaude Codeで使う前に確認したい権限設定、APIキー、ファイル操作の注意点を解説します。

公開 2026.05.24 / 更新 2026.07.01

この記事のポイント

  • MCPとは、AIエージェントと外部ツール・データソースをつなぐ仕組み
  • ファイル操作、DB参照、GitHub連携、ブラウザ操作などが便利になる
  • 最初は読み取り中心、権限は最小限、よく分からないMCPサーバーは使わない

冒頭の結論:MCPはAIに外部窓口を持たせる仕組み

MCPとは、AIエージェントと外部ツール・データソースをつなぐための仕組みです。初心者向けに言えば、AIに手足や外部窓口を持たせるようなものです。AIが会話だけでなく、ファイル、データベース、GitHub、ブラウザ、ローカルツールなどにアクセスしやすくなります。

ただし、便利さとリスクは表裏一体です。AIが外部ツールに触れるということは、読み取り、書き込み、削除、外部送信、本番環境操作の可能性も出てきます。個人開発でも、権限設計を軽く見ると普通に事故ります。

この記事で分かること

  • MCPとは何か、AIエージェントとどう関係するのか
  • MCPで便利になる作業の具体例
  • 個人開発者が注意すべきセキュリティリスク
  • 最初に試すときの安全な考え方

MCPでできることとリスク

MCPでできること便利な場面リスク初心者が注意すること
ファイル操作コードや設定ファイルを読み、修正案を作る誤削除、不要な上書き、秘密情報の表示最初は読み取り中心にする
データベース参照データ構造を見ながら実装方針を考える本番データ変更、個人情報の露出本番DBへの書き込み権限を渡さない
GitHub連携Issue、PR、差分を見ながら作業する意図しないPR作成や公開pushや公開操作は確認制にする
ブラウザ操作画面確認、フォーム挙動、表示崩れ確認ログイン済みページでの誤操作重要操作はクリック前に止める
社内・個人ドキュメント参照仕様書やメモをもとに回答する機密情報の扱いが重くなる参照範囲を限定する
ローカルツール連携ビルド、テスト、変換処理を自動化する破壊的コマンドの実行削除や本番反映を許可しない

CodexやClaude CodeでMCPを使う前の確認

  • 接続先のMCPサーバーが何を読み、何を書けるか確認する
  • APIキーやトークンをどこに保存し、AIに値を見せないか決める
  • ファイル操作は読み取りから始め、削除や一括編集は確認制にする
  • GitHub、ブラウザ、DB、本番環境への操作は人間が最後に判断する
  • 便利そうという理由だけで、出所不明のMCPサーバーを追加しない

個人開発者にとって重要な理由

個人開発では、AIエージェントに任せたい作業が増えます。記事追加、ビルド確認、GitHubのIssue整理、ローカルファイルの確認、ブラウザでの表示チェックなどです。MCPを使うと、こうした作業をAIが扱いやすくなります。

一方で、個人開発者は権限管理も一人で背負います。会社のようにレビュー担当、セキュリティ担当、運用担当が分かれていないため、自分で止める場所を設計する必要があります。

向いているケース

  • ローカルのドキュメントやコードを読みながらAIに整理させたい
  • GitHubのIssueやPRと連携して作業を進めたい
  • ブラウザ表示を見ながらUIの崩れを確認したい
  • 社内ではなく個人の範囲で、読み取り中心に小さく試したい

向いていないケース・注意点

  • APIキーや秘密情報にアクセスできる設定は慎重にする
  • ファイル削除や本番環境操作を許可しない
  • 最初は読み取り中心から試す
  • 権限を最小限にする
  • 外部送信がある場合は、何がどこへ送られるか確認する

よくある誤解

MCPを入れればAIエージェントが何でも安全に自動化してくれる、というのは誤解です。MCPは接続の仕組みであって、安全運用そのものではありません。安全にするには、読み取りと書き込みを分け、危険操作を確認制にし、権限を必要最小限にする必要があります。

MCPのFAQ

MCPとは何ですか?

MCPは、AIエージェントが外部ツールやデータソースに接続するための仕組みです。ファイル、GitHub、ブラウザ、DBなどをAIが扱いやすくなります。

MCPは危険ですか?

MCP自体が危険というより、渡す権限が広すぎると危険です。読み取り、書き込み、削除、外部送信、本番操作の範囲を確認してから使います。

初心者はMCPを何から試すべきですか?

まずは読み取り中心の連携から試すのがおすすめです。ファイル削除、本番DB、公開操作、秘密情報を扱う連携は後回しにしてください。

MCPでAPIキーが漏れることはありますか?

設定やログの扱いを誤ると漏れる可能性があります。APIキーの値をAIに表示させず、接続先と保存場所を人間が確認する運用にしてください。

CodexやClaude CodeでMCPを使うときの注意点は?

作業範囲、接続先、権限、実行コマンドを先に確認し、pushやdeploy、本番操作はAIに自動実行させず人間が確認するのが安全です。

まとめ:MCPは便利だが、権限設計が本体

MCPとは、AIエージェントに外部ツールやデータソースへの接点を持たせる仕組みです。個人開発でも強力ですが、最初は読み取り中心、権限は最小限、危険操作は人間が確認する。この線引きなしに使うと、便利さより事故の方が先に来ます。

MCPは外部ツール権限の入口としてレビューする

MCPはAIエージェントに道具を渡す仕組みです。便利さが増えるほど、読み取り、書き込み、外部送信、削除、ログの境界が重要になります。MCP追加は機能追加ではなく権限追加としてレビューします。

見る観点確認すること関連する新規記事
読み取りどのファイル、DB、ブラウザ情報を読めるかai-agent-task-boundary-for-coding
書き込み削除、更新、push、外部送信ができるかai-coding-dangerous-permissions
ログ何を実行したか後から追えるかhow-to-review-codex-completion-report

AIコーディング生産性まわりの補足FAQ

MCPを入れれば作業は必ず速くなりますか?

必ずではありません。外部ツール権限が増えるほど確認項目も増えます。読み取りから始め、書き込みは段階的に許可する方が安全です。

ZCodeのMCP importは便利だが、権限拡張として扱う

ZCodeはClaude Code、Codex CLI、OpenCodeなど外部AgentのMCP設定をscanし、importできると説明されています。これは再設定の手間を減らしますが、安全装置ではなく権限拡張です。

ZCodeで見る項目確認すること詳しく読む
Configured MCP手動追加serverのcommandとscopeを見るzcode-mcp-agents-md-subagents
Plugin MCPplugin管理のserverを有効/無効で確認zcode-mcp-agents-md-subagents
Importglobal/workspace scopeとAPIキー扱いを確認zcode-mcp-agents-md-subagents

ZCode補足FAQ

ZCodeでMCPをimportすれば安全ですか?

安全とは限りません。import前後でserverの読み書き範囲、外部通信、secret、workspace scopeを確認します。

MCPを実際に導入する前の権限チェック

MCP入門としての役割は維持し、導入前の権限設計は最小権限ガイドへ分けます。MCPはAIに道具を増やす仕組みなので、最初から強い権限を渡さないことが大切です。

確認観点この記事で扱うこと詳しく読む
読み取り対象範囲を限定するmcp-permission-least-privilege-guide
書き込み小さなテスト範囲から始めるmcp-permission-least-privilege-guide
認証情報APIキーの実値を見せないapi-key-env-secret-safety-ai-coding
外部送信送信先とログを確認するmcp-permission-least-privilege-guide

AI coding agent安全運用の補足FAQ

MCPは危険だから使わない方がいいですか?

使うこと自体が悪いわけではありません。読み取り、書き込み、削除、外部送信、認証情報アクセスを分け、最小権限で始めるのが現実的です。

関連記事