MCPで外部サービスとつなぐ

ローカルから外の世界へ

入門編でやったことを思い出してほしい。ファイルを作って、コードを書いて、Gitでコミット。全部パソコンの中で完結していた。

でも実際の仕事はそうじゃない。Notionにメモがあるし、Googleカレンダーで予定を管理してるし、データベースに患者統計が入っている。Claude Codeからそこに手が届かないのは、正直もったいない。

MCPがその壁を取っ払ってくれる。

MCPとは何か

MCPはModel Context Protocolの略。正式名称はどうでもいい。

要するに、Claude Codeと外部サービスをつなぐケーブルだ。プリンターにUSBを挿すと印刷できるようになるのと同じ感覚で、設定ファイルに数行書くだけでClaude Codeが新しいサービスを操れるようになる。

Notion用のケーブル、カレンダー用のケーブル、GitHub用のケーブル。1本ずつ独立してるから、使いたいものだけ足せばいい。

まずはやってみる: Notion MCPの接続

設定ファイルは ~/.claude/settings.json にある。中身を確認してみよう。

$cat ~/.claude/settings.json

まだ何も設定していなければ、空か基本設定だけが入っているはず。ここにMCPの設定を足していく。

Claude Codeを起動して、こう伝える。

Notion MCPを設定して。公式のAnthropic Notion MCPを使いたい。

Claude Codeが設定を書き込んでくれる。こんな形になる。

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@anthropic/notion-mcp"]
    }
  }
}

設定を反映させるには再起動が必要だ。

$claude

再起動したら試してみよう。

Notionで最近更新したページを教えて

初回はClaude Codeから許可を求められる。OKすると、Notionに接続してページ一覧を引っ張ってきてくれる。

たったこれだけ。settings.jsonに数行足しただけで、Claude CodeがNotionを読み書きできるようになった。

次に: Googleカレンダーをつなぐ

同じ要領でGoogleカレンダーもいける。

Google Calendar MCPも追加して

再起動して試す。

今日の予定は？

カレンダーを見に行って、今日の予定を一覧で返してくれる。朝の確認作業がClaude Codeとの会話だけで済む。

よく使うMCPサーバー

医師の業務で使い出がありそうなものを挙げておく。

全部入れる必要はない。使うものから1つずつ。

MCPの裏側で起きていること

仕組みを少しだけ理解しておくと、トラブル時に落ち着ける。

あなた → Claude Code → MCPサーバー → 外部サービス（Notion等）
                ↑            ↑
          チャットで指示   裏で自動通信

MCPサーバーはClaude Codeの横で動く小さなプログラムだ。Claude Codeが「Notionのページを読みたい」と判断すると、MCPサーバーに依頼を出す。MCPサーバーがNotionのAPIを叩いて結果を持ち帰る。

あなたが触るのはsettings.jsonだけ。インストールも通信も裏で勝手にやってくれる。

トラブルが起きたら

MCPがうまく動かないとき、原因はだいたい3つに絞られる。

1. JSONの構文ミス

カンマが抜けてる、括弧が閉じてない。一番多い。

settings.jsonの構文をチェックして

Claude Codeに頼めば一発で直る。

2. 認証が通ってない

NotionやGoogleは初回にブラウザで認証を求めてくることがある。エラーメッセージにURLが出たら、ブラウザで開いて認証する。

こんなエラーが出たら認証の問題だ。

Error: Not authenticated. Please visit:
https://accounts.google.com/o/oauth2/...

このURLをブラウザで開いて、Googleアカウントでログインすればいい。

3. 再起動し忘れ

settings.jsonを変えたら必ず再起動。これ、地味に忘れやすい。

$/exit
$claude

迷ったら「再起動した？」を最初に確認する。これだけで半分のトラブルが解決する。

まとめ

MCPはClaude Codeと外部サービスをつなぐケーブル。設定ファイルに数行書いて再起動するだけ。Notion、カレンダー、GitHub、PubMed。仕事で使っているツールをClaude Codeから操れるようになる。

次のレッスンでは、テストについて学ぶ。医療アプリでは特に重要だ。薬の用量計算を間違えたら命に関わる。テストがその安全網になる。