Claude Code MCP設定｜業務ツール連携の実装ガイド

本記事は、Claude CodeでMCPサーバーを設定し、業務で使う主要ツール（GitHub・Slack・Notion・Figma・各種DB）と連携する手順を、設定ファイル例とトラブルシュートまで含めて整理したものです。LiftBaseの開発・コンサル現場で、20以上のMCPサーバーを日次稼働させているノウハウを公開します。

「MCP導入で開発が速くなる」のではなく「MCPを介してClaude Codeが社内ツール群と一気通貫で接続される」のが本記事のゴールです。

MCPで何ができるか。3つの接続パターン

MCPは大きく3つの接続パターンに集約できます。

1. 公式MCP（Anthropic公開・GitHub/Slack/Filesystem等）
Anthropic公式が提供するリファレンスサーバー群。GitHubのIssue操作、Slackメッセージ送信、ファイルシステム読み書きなど、一般用途の基本セット。

2. サードパーティMCP（Notion／Figma／Linear／DBドライバ）
各ツールベンダーやコミュニティが公開しているMCPサーバー。npm install や npx で動く軽量実装が多く、社内Wikiや業務SaaSとの連携に有効です。

3. 自社開発MCP（独自業務ロジック）
社内DB、独自API、特定の業務フロー（経理・人事・営業）をClaude Codeから呼べるようにする実装。Python／TypeScript SDKがあり、3〜5日で1サーバー作れます。

3パターンのうち、最初に投資すべきは「公式MCP」です。理由は「設定が標準化されている」「ドキュメント・サンプルが豊富」「次の領域への踏み台になる」の3点です。

最初の1サーバー：GitHub MCPから始める理由

MCPで失敗する人の共通点は「いきなり自社MCPを作る」ことです。MCPの仕組みに慣れていない状態で独自実装に着手すると、protocol準拠のチェックや設定ファイルでつまずきます。

最初の1サーバーを選ぶ基準は3つ。

基準1：公式・準公式の整備されたMCP
GitHub、Slack、Filesystem は公式リファレンスがあり、設定例も豊富。これらから始めれば「MCPの動かし方」を最短で理解できます。

基準2：エンジニアの作業に直結すること
GitHub Issue起票、PR作成、Slack通知などは日次の作業頻度が高く、効果が早期に見えます。経営ツールよりエンジニアツールから入るのが定石です。

基準3：他領域への波及があること
GitHub MCPで蓄積した「ツール呼び出しパターン」は、後で社内独自MCPの設計に再利用できます。

3基準すべて満たすのは、ほぼGitHub MCPです。npx 一発で起動でき、5分で動作確認できます。

MCP設定ファイル（.mcp.json）の書き方

Claude CodeのMCP設定はプロジェクトルートの .mcp.json または ~/.claude/mcp.json に書きます。基本形を示します。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxx"
      }
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-xxxxx",
        "SLACK_TEAM_ID": "T012345"
      }
    },
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer secret_xxx\"}"
      }
    }
  }
}

書き方の要点。

• command と args は MCP サーバーの起動コマンド
• env は環境変数（API キー・トークン等）
• 機密情報は .env を読む形にして、.mcp.json 自体はコミットする運用が定石

設定ファイルを書いたら Claude Code を再起動するだけで MCP サーバーが認識されます。

主要ツール別の設定例とトラブルシュート

業務でよく使う4ツールの設定例とハマりどころ。

GitHub MCP

用途: Issue起票・PR作成・コードレビュー連携・リポジトリ検索
取得するもの: GitHub Personal Access Token（repo / read:user / workflow スコープ）
ハマりどころ: トークンの権限不足。Organization のリポジトリは別途 SSO 認可が必要。

Slack MCP

用途: 特定チャネルへの通知・スレッド作成・履歴取得
取得するもの: Slack Bot Token（OAuth で発行）+ Team ID
ハマりどころ: Bot を該当チャネルに招待しないと投稿できない。/invite @bot-name を忘れない。

Notion MCP

用途: 社内Wiki検索・ページ作成・データベース更新
取得するもの: Notion Internal Integration Token + 対象ページに Integration を接続
ハマりどころ: Integration をページに「接続」しないと401で弾かれる。Notion画面の「…」メニューから接続。

ファイルシステム MCP

用途: 指定ディレクトリの読み書き（プロジェクト外のドキュメント参照）
取得するもの: なし（ディレクトリパスのみ）
ハマりどころ: 全ディスクを許可せず、必要なディレクトリだけスコープを絞る。セキュリティ事故の温床。

MCP導入のリアル試算（エンジニア5名チーム）

「MCP連携で何時間浮くか」がどのくらいの規模感か、具体的に見ておきます。エンジニア5名・週40時間稼働のチームモデルで試算します。

時給5,000円換算で月40万円、年間480万円分の業務時間が浮く計算です。これは「便利になる」ではなく、エンジニアが本来の実装・設計業務に時間を振り向ける効果として現れます。

MCP設定でつまずく5つの罠

支援現場で繰り返し見てきた、ハマりやすい5つの罠。

罠1：API キー・トークンを .mcp.json に直書き

.mcp.json をコミットすると認証情報が漏れます。.env から読む形にし、.gitignore で .env を除外する。

罠2：権限スコープ広すぎ

GitHub Token に admin:org を付ける、Slack Bot を全チャネルに招待する、など。最小権限の原則を守る。漏洩時の被害を限定する設計です。

罠3：MCP サーバーの過剰追加

最初から10サーバー入れるとデバッグが困難に。1〜2サーバーで運用が回ってから追加する。

罠4：自社MCPをいきなり実装

公式MCPで挙動を理解する前に独自実装すると、protocol 準拠のテストで詰まります。公式から学ぶ順序を守る。

罠5：機密情報をMCP越しにAIへ流す

顧客個人情報、本番DB接続文字列、給与データなどを「MCPで読めるから」と接続するのは危険。Anthropicは学習オプトアウトを提供していますが、機密データはそもそもMCPで触らせない設計が原則です（出典：Anthropic Privacy Policy、Model Context Protocol 公式仕様）。

段階別ロードマップ：0-30日 / 31-60日 / 61-90日

実装の順序を、3フェーズに分けて整理します。

フェーズ1：0-30日（公式MCPで基礎構築）

• GitHub / Slack / Filesystem の3つを .mcp.json に設定
• エンジニア1名で動作確認
• API キー管理ルール（.env + .gitignore）を確立
• チーム展開のための運用ガイドを Notion 等に整備

このフェーズの目的は「MCPの仕組みを骨に入れる」ことです。3サーバーで業務が回るのを体感する。

フェーズ2：31-60日（業務ツールMCP拡張）

• Notion / Linear / Figma など業務SaaSのMCPを追加
• 各サーバーの権限スコープを最小化
• チーム5名でMCP併用フローを定着

60日時点で、Claude Codeから社内SaaS群を一気通貫で操作できる状態を作ります。

フェーズ3：61-90日（自社MCP実装）

• 独自業務ロジックのMCPサーバーをPython / TypeScriptで実装
• 社内DBや独自APIへの接続を1〜2本追加
• 月運用で月80時間削減を達成

90日時点で、MCPが「個人ツール」から「社内インフラ」に格上げされます。詳細はClaude Codeのチーム導入ロードマップも参照ください。

よくある質問

Q1. MCPはClaude Code以外でも使えますか？

使えます。MCPはAnthropicが提唱するオープン標準で、Claude Desktop・Claude API・Codex CLIなど他のクライアントもサポートしています。同じMCPサーバーを複数クライアントで再利用できるのが利点です。

Q2. 自社MCPの実装は難しいですか？

公式SDK（Python / TypeScript）があるため、最低限の MCP サーバー（READ専用ツール3つ程度）なら3〜5日で実装できます。複雑な業務ロジックを組み込むと2〜3週間かかります。

Q3. 設定ファイルはどこに置くべきですか？

プロジェクト共通なら ~/.claude/mcp.json、リポジトリ固有なら <repo>/.mcp.json に置きます。後者はチーム全員で共有する場合に便利です。機密値は .env に切り出して、.mcp.json 自体はコミットする運用が定石です。

Q4. MCPサーバーが起動しない時は？

3点確認します：（a）command と args のパスが正しいか、（b）環境変数が読み込まれているか、（c）Claude Codeを再起動したか。Claude Codeのログ（コマンドパレットから Output を確認）にエラーが出ていることが多い。

Q5. 失敗した場合のリスクは？

最大のリスクは「権限スコープが広すぎる MCP を介して情報漏洩・誤操作が起きる」ことです。これを避けるため、（a）最小権限の原則、（b）機密情報をMCPに流さない、（c）destructive 操作（削除・送信）には事前確認、の3点を運用ルールに組み込んでください。

30分の無料AI業務診断

Claude CodeとMCPで社内ツール連携を進めたい方に向けて、30分の無料AI業務診断を実施しています。設定ファイル整備、自社MCP実装支援、チーム展開まで、現場ヒアリングをもとにご提案します。

▶ 無料AI業務診断を申し込む（30分・オンライン）

営業・経理・人事の「どこから始めるか」を、無料で見える化します

30分の無料AI業務診断
御社の業務フローをヒアリングし、AIで何時間が浮くか・どこから始めるべきかを可視化します。
「いきなり契約」ではありません。診断結果のレポートだけでも持ち帰れます。

▶ 無料AI業務診断を申し込む

まずは話を聞いてみたい方は、無料相談から

無料相談（オンライン30分）
「うちの業界でAIは効くのか」「他社事例を聞きたい」「何から手をつけていいか分からない」など、
ふんわりした疑問でも結構です。営業出身の代表 渋谷が直接お話しします。

▶ 無料相談を申し込む

執筆者プロフィール

渋谷祐太（しぶや ゆうた）｜株式会社LiftBase 代表取締役CEO

学生時代に株式会社エス・エム・エスでインサイドセールスに従事し、顧客接点と業務プロセス設計の基礎を学ぶ。新卒で日本IBMに入社し、コンサルタントとして大手クライアントの業務改革・システム導入を担当。その後、ファインディ株式会社で事業企画としてプロダクトと事業の接続を経験。2024年9月に株式会社LiftBaseを創業し、代表取締役CEOに就任。AI導入が「実装段階で止まる」課題に向き合い、Claude Code・Codex を中心とした AI ネイティブな開発体制づくりを支援している。

「テクノロジーは、使い方次第でビジネスの構造そのものを変える力を持っている。中小企業の『あと一歩』の壁を、現場と経営の両方から越えていきます。」

関連記事

• Claude Codeはじめての使い方
• Claude Codeプロンプト書き方
• Claude Code業務活用ユースケース