Chapter 1

MCP・コネクタ・API ─ Claude Code を外のサービスとつなぐ3つの方法

1. 三層とは何か

Claude Code が外部サービスと話す方法は、大きく3種類あります。

2. 第1層：コネクタ

2-1. コネクタとは

コネクタは、よく使われるサービスとの接続を、設定画面のボタンだけで完結させる仕組みです。

コードも設定ファイルも不要です。

2-2. 使えるコネクタ（主なもの）

コネクタの一覧は、Claude Code の設定 → コネクタ から確認できます。

2-3. Gmail コネクタをつないでみる

実際にやってみます。多くの方が使っている Gmail コネクタ を例にします。

手順

1. Claude Code の設定を開く
2. 「コネクタ」タブを選択
3. Gmail の「接続」ボタンをクリック
4. Google アカウントのログイン画面が出るので、ログイン
5. アクセス権限を確認して「許可」
6. 設定画面に戻ると、Gmailが「接続済み」になっている

動作確認

接続が完了したら、チャット欄でこう入力します。

今週届いたメールのうち、返信が必要そうなものを5件ピックアップして、
件名と差出人と要点を表にしてください。

Claude Code が Gmail にアクセスし、メールを読んでまとめてくれます。

2-4. Google Calendar コネクタも便利

同じ手順で Google Calendar コネクタも繋げられます。例：

来週の予定を一覧にして、空いている時間帯（30分以上）も教えてください。

「予定を見ながら相手と日程調整する」作業が一気に短くなります。

3. 第2層：MCP（Model Context Protocol）

3-1. MCPとは

MCP は、AI が外部ツールと通信するための共通のプロトコル（通信規格）です。

コネクタがない（または自分で拡張したい）サービスとつなぐ時に使います。

コネクタもMCPを使って作られています。コネクタは「MCP接続を簡単にした入口」と考えると分かりやすいです。

3-2. MCPサーバーとは

MCPは「MCPサーバー」というプログラムを間に挟む形で動きます。

Claude Code ─── MCPサーバー ─── 外部サービス

MCPサーバーは、Claude Code と外部サービスの「通訳係」です。

既製のMCPサーバーが多数公開されています。設定ファイルに数行追加するだけで使えます。

3-3. 設定の方法

Claude Code の設定 → MCP サーバー に進みます。

「サーバーを追加」で、MCPサーバーの情報を入力します。

例：ファイル操作用の MCP サーバーを追加する場合

以下は JSON 形式（設定を構造的に書くテキスト形式）の例です。

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/folder"]
    }
  }
}

ここで補足。最近のサービスは Remote MCP（OAuth 認証で接続） に切り替わってきています。

OAuth とは、パスワードを直接渡さずに「この範囲だけ操作を許可」と認可するログイン方式のこと。Google アカウントで他サービスにログインする時の仕組みと同じです。最新の接続方法は各サービスの開発者ドキュメントを確認してください。

3-4. どんなMCPサーバーが使えるか

MCPサーバーは世界中の開発者が作っていて、GitHub や npm で公開されています。

よく使われるもの：

4. 第3層：Anthropic API

4-1. APIとは

API は、プログラムから Claude AI の機能を直接呼び出す仕組みです。

「自社のシステムに Claude を組み込む」「定期実行スクリプトを書く」「他のシステムと連携する」といった用途に使います。

4-2. 無料の API でまず1つサイトを作ってみる

API を本格的に使う前に、無料で公開されている練習用 API を使って小さなサイトを作るのが、いちばん早い理解の道です。

章7（LP制作）と同じ流れで、Claude Code にお願いするだけで作れます。おすすめは次の2つ。

例1：ボタンを押したらポケモンが出てくるサイト

PokeAPI（pokeapi.co）は、ポケモンのデータを返してくれる無料APIです。登録もキーも不要で、すぐ使えます。

Claude Code に頼む例

PokeAPI を使って、こんなサイトを1ページ（index.html）で作ってください。

- 真ん中に「ポケモンを呼ぶ」ボタンが1つ
- ボタンを押すと、ID 1〜151 の中からランダムに1匹選んで、
  「名前」「画像」「タイプ」が表示される
- もう一度押すと別のポケモンが出てくる
- 子どもが見ても楽しい、シンプルで明るい配色

数分で動くサイトができます。「APIから情報を取って、画面に出す」という流れが、目で見てすぐわかります。

例2：自宅の近くの図書館を探せるサイト

カーリル図書館API（calil.jp/doc/api.html）は、全国の図書館を検索できる無料APIです。登録すればAPIキーがもらえ、すぐ使えます。

Claude Code に頼む例

カーリル図書館API（https://calil.jp/doc/api_ref.html）を使って、
こんなサイトを作ってください。

- 郵便番号 or 都道府県＋市区町村を入力する欄が1つ
- 「探す」ボタンを押すと、近くの図書館の名前・住所・URL がリストで出る
- スマホでも見やすい1ページ構成
- APIキーは環境変数 CALIL_API_KEY から読むようにしてください
- .gitignore も合わせて作ってください

実用的なサイトになるので、家族や子どもに「使ってみて」と渡すこともできます。

ここで「API → 取得 → 画面表示」の流れを体感してから、有料の Anthropic API へ進むと迷いません。

4-3. Claude Code に API を扱わせる時の3つのコツ

API を Claude Code に扱わせるときに、最初に意識しておきたい3点があります。これを守れば、トラブルの9割は防げます。

コツ1：APIキーはコードに直接書かない

APIキーは「自分専用の鍵」です。コードに直接書いて GitHub に上げてしまうと、世界中に鍵が公開された状態になり、不正利用されてしまう事故が後を絶ちません。

正しい渡し方：環境変数または .env ファイルに分けて、コード側は変数名だけ書きます。

import os
api_key = os.environ["CALIL_API_KEY"]

コツ2：.env を .gitignore で除外する

.env ファイルを使う場合は、.gitignore に .env を必ず入れて、GitHub に上げないようにします。

Claude Code に頼むときは「.gitignore も合わせて作って」と一言添えるだけ。書き忘れる心配がなくなります。

コツ3：APIのドキュメントURL を一緒に渡す

Claude Code に「このAPIを使って」と頼むだけだと、AIが推測で書いて間違える（古いバージョンの仕様で書く・存在しないエンドポイントを叩く等）ことがあります。

対策はシンプル。APIのドキュメントURL（または該当ページのテキスト）を一緒に渡します。

○○APIを使ってサイトを作ってください。
ドキュメント：https://example.com/api/docs
APIキーは環境変数 ○○_API_KEY から読むようにしてください。
.gitignore も合わせて作ってください。

この一手間で、Claude Code は公式仕様に沿った正しいコードを書いてくれます。「APIキーは環境変数」「ドキュメントを渡す」「.gitignore を作る」、この3点セットを毎回意識してください。

4-4. Anthropic API を使う

無料APIで感覚をつかんだら、本番の Anthropic API を使います。

ここから先は有料になります。事前にチャージしたぶんから使った量が引かれる従量課金です。

import os
import anthropic

# 4-3のコツ通り、APIキーは環境変数から読みます
client = anthropic.Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])

# モデル名は実行時点の最新版に置き換えてください（例：claude-haiku-X-X）
message = client.messages.create(
    model="claude-haiku-X-X",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "今月のKPIファイルを読んで要約してください"}
    ]
)
print(message.content)

モデル名は実行時点の最新版を Anthropic ドキュメントで確認してください。Opus・Sonnet・Haiku の3系統があり、用途と予算でモデルを選びます。

Claude Code に頼むときも、Anthropic API のドキュメント（docs.anthropic.com）を URL で渡しておくと、最新の書き方で正しく書いてくれます。

4-5. 料金の目安

API は別途料金がかかります（使った分だけの従量課金）。

Pro プランのサブスクリプションとは別に、API の利用料金が発生します。料金は モデル × トークン量 で決まります。

5. 三層の選び方

どの層を使えばいいか、判断の目安をまとめます。

判断フロー

1. 「コネクタ」の一覧にある？
   → YES: コネクタを使う（最も手軽）
   → NO: 次へ

2. 既製の「MCPサーバー」が公開されている？
   → YES: MCP設定を追加して使う
   → NO: 次へ

3. 自社システムと連携したい？定期実行したい？
   → YES: API（プログラムが必要）
   → NO: そもそも Claude Code でやる必要がない作業かも

具体例

6. 実践：コネクタを使って Gmail＋Calendar を一気に把握する

ここで1つ実践例を通して流れを確認します。

前提

• Gmail コネクタ・Google Calendar コネクタが接続済み

指示

今週の状況を、以下の形でまとめてください。

1. 今週届いた重要メール（返信が必要なもの上位5件）
2. 今週の残り予定一覧
3. 来週の予定一覧（30分以上の空き時間も教えて）
4. このうち、今日中にやっておくべきこと（推奨）

結果

Claude Code が Gmail と Calendar の両方にアクセスし、横断して状況をまとめてくれます。

手動でアプリを開き直す必要はありません。「週の頭にこれを聞く」だけで、その週の動き方が15秒で見えるようになります。

まとめ

この章で押さえたこと3点：

1. 外部接続は「コネクタ→MCP→API」の三層。難易度と自由度のトレードオフ
2. まずコネクタ（Gmail / Calendar / Drive 等）から始める。設定画面3クリックで完結
3. APIは「自社システム連携」「定期実行」が必要になってから

次章では、Claude Code をブラウザと組み合わせる「Claude for Chrome」を扱います。WebリサーチをしながらClaude Codeで分析する合わせ技を体験します。

Chapter 5

スキル設計の深掘り

はじめに ─ レシピから部品へ

前章では、「議事録要約」「外注費アラート」など、すぐ使える業務自動化レシピを6本見てきました。コピペしてそのまま動かすことで、Claude Code に何を任せられるかの輪郭が掴めたはずです。

そのレシピを毎週・毎月使うようになると、ある瞬間に思うようになります。「この一連の手順、毎回プロンプトに貼り直すのは面倒だな」「同じ処理を別のエージェントからも呼びたいな」と。

ここで登場するのが、本章の主題であるスキルです。スキルは、レシピを「部品化」して、複数のエージェントから呼び出せる形にしたもの。レシピの便利さを保ったまま、「毎週使うもの」「複数の係から共通で呼ばれるもの」を整理する道具です。本章ではその設計の作法と、3つのスコープ（プロジェクト・ユーザー・プラグイン）の使い分けを扱います。

1. スキルとは何か

スキルとは、Claude Code が実行できる「特定の手順書」です。

エージェントが「誰」かを定義するのに対して、スキルは「何ができるか」を定義します。

例で理解する

月次レポート担当エージェントは、「KPI集計スキル」と「報告書フォーマットスキル」を組み合わせて動きます。

2. スキルファイルの場所（3層スコープ）

スキルファイルを置く場所によって、使える範囲が変わります。

3層の概要

実務での選び方

3. スキルファイルの書き方

スキルは Markdown ファイルで記述します。

.claude/skills/
└── skill-kpi-summary.md

基本構造

# KPI 集計スキル

## 目的

月次KPIデータを集計し、比較表と傾向コメントを生成する。

## 入力

- 今月実績ファイル（CSV または Excel）
- 先月実績ファイル（CSV または Excel、任意）

## 処理手順

1. 各ファイルを読み込んで数値を確認する
2. 主要指標を抽出する（指定がなければファイルの全列）
3. 今月・先月・前年同月の3列比較表を作成する
4. 増減率を計算する（小数点1位まで）
5. 改善指標・悪化指標をそれぞれ最大3点抽出する

## 出力

- 比較表（Markdown 表形式）
- 傾向コメント（200字以内）

## 注意事項

- 数字は出典ファイル名と列名を必ず記載する
- 計算は Claude が行わず、ファイルの元数値をそのまま使う
- 前年同月データがない場合は「前年同月データなし」と明記する

良いスキル説明文の条件

1. 目的が1文で書けている：何のためのスキルか一目でわかる
2. 入力と出力が明確：何を渡せば何が出てくるか
3. 手順が順番に書かれている：迷いが起きないよう、ステップを番号付きで
4. 注意事項がある：よくある誤りやブレを防ぐルール

4. スキルを呼び出す

スキルを使う時は、エージェントファイルの中から参照します。

# 月次レポート担当

## 使用するスキル

- @skill-kpi-summary.md（KPI集計）
- @skill-report-format.md（報告書フォーマット）

## 処理フロー

1. KPI集計スキルでデータを集計する
2. 報告書フォーマットスキルでレポートを整形する
3. 完成したレポートをファイルに保存する

またはチャット欄で直接呼ぶこともできます。

@skill-kpi-summary.md を使って、@今月実績.csv を集計してください

5. スキルのバージョン管理

スキルは使いながら少しずつ手を入れて精度を上げる前提なので、変更履歴を追えると安心です。

シンプルな管理方法

ファイル末尾に変更履歴をコメントとして記録します。

---
## 変更履歴

- v1.0 (2025-04-01): 初版
- v1.1 (2025-04-15): 前年同月比較を追加
- v1.2 (2025-05-01): 注意事項に「計算ミス防止」を追記

大幅に変える場合は、skill-kpi-summary-v2.md としてコピーしてから変更するのが安全です。

6. スキルの再利用パターン

実務でよく使われる「スキルの部品」をまとめます。

これらを汎用部品として作っておくと、新しいエージェントを作る時に組み合わせるだけで済みます。

まとめ

この章で押さえたこと3点：

1. スキルは「何をするか」の手順書。エージェントが「誰」の定義なのと対照的
2. 3層スコープ（プロジェクト・ユーザー・プラグイン）で使える範囲を使い分ける
3. 汎用スキルを部品として作っておくと、新しいエージェントを素早く組める

次章では、エージェント設計を単独エージェントとして深掘りします。ペルソナ設計・ルーティングルール・記憶と実行ログなど、初級編より一段深い設計の話をします。

Chapter 9

高度なセキュリティ・コンプライアンス

1. 個人情報保護法（改正版）の実務ポイント

社内展開を進めると、必ず最初に問われるのが「個人情報の取り扱い」です。難しく見えますが、押さえるべきポイントは限られています。まずはここから整理しましょう。

1-1. 「要配慮個人情報」は別格で扱う

一般的な個人情報（氏名・住所・電話番号）と、より慎重な扱いが必要な「要配慮個人情報」は区別して考えます。

要配慮個人情報は、本人の同意なしに収集・利用することが禁止されています。AI ツールへの入力（＝外部送信）は「第三者提供」に該当する可能性があります。

1-2. 第三者提供の考え方

Claude Code の入力データは Anthropic のサーバーを経由します。これが「第三者提供」に当たるかどうかは、目的・内容・契約によって異なります。

実務的な対応：

• 個人情報を含むデータを渡す場合は、仮名加工または匿名加工してから渡す
• 大量の個人情報を処理する業務（顧客DBの分析など）は、法務・コンプライアンスに事前相談する

1-3. 利用目的の明示

個人情報保護法では、個人情報を収集する際に「利用目的」を明示することが必要です。

AI 活用が社内で進むと、「社内の個人情報をAIで分析する」という目的が生じます。社内規定の「利用目的」の記載が最新かどうか確認してください。

2. マイナンバーの取り扱い

マイナンバー（個人番号）は、利用できる業務がマイナンバー法（番号法）で厳格に限定されています（同法9条：利用範囲、19条：提供制限）。社会保障・税・災害対策の3分野以外での利用は禁止です。

絶対にやってはいけないこと

• マイナンバーを含む書類を、そのままClaude Codeに渡す
• マイナンバーが含まれるExcel・PDFを作業フォルダに置いたまま処理する

実務的な対応

マイナンバーが含まれるデータを扱う場合：

1. マイナンバーの列・フィールドを削除してから渡す
2. 処理対象のファイルにマイナンバーが含まれないことを確認してから作業フォルダを指定する

3. NDA（守秘義務契約）への実務対応

取引先との守秘義務契約で問題になりやすいのは、「AI ツールへの入力」が「開示」や「利用」に当たるかどうかです。

確認フロー

1. 該当する契約書の守秘義務条項を確認する
2. 「第三者への開示」「外部委託」に関する記述があるか確認する
3. AI ツールへの入力が「開示」と解釈される可能性があれば
   → 先方の担当者に確認する
   → 確認が取れるまでは仮名化して渡す
4. 新規契約を締結する際は「AI ツール利用」の条項を追加する

新規契約書へのAI利用条項（参考文例）

乙は本契約に関連する業務においてAIツールを利用することができる。
ただし、甲から提供を受けた秘密情報をAIツールに入力する場合は、
事前に甲の書面による承諾を得るものとする。

4. 業種別の追加注意点

医療・介護

• 電子カルテ・診療記録は「要配慮個人情報」かつ「医療情報」。最高レベルの慎重さが必要
• 患者情報を含む文書を AI 処理する場合は、医療情報システムの安全管理に関するガイドライン（厚労省）と関連する3省2ガイドライン（経産省・総務省含む）を確認
• 病院・クリニック側は、ベンダーとの間で「個人情報の取扱いの委託契約」を締結する必要がある

金融・保険

• 顧客の取引情報・資産情報は金融商品取引法・銀行法等の規制対象
• 重要事実（金融商品取引法の「未公表の重要事実」、未公開の業績・M&A 情報等）はインサイダー取引規制の対象。AI ツールへの入力は厳格に避ける
• 社内のコンプライアンス部門の事前承認なしに業務データを外部サービスに送らない

士業（弁護士・会計士・税理士等）

• 依頼者情報は守秘義務の対象。依頼者の明示的な同意なしに外部送信しない
• 依頼者名が含まれる書類は仮名化が最低条件

5. インシデント対応フロー

インシデントとは

Claude Code に関連する問題が発生した場合の対応を事前に設計しておきます。

想定されるインシデント：

• 個人情報が含まれるファイルを誤って渡してしまった
• Anthropic のサービスがデータ漏洩を発表した
• 取引先からAIツール利用に関する問い合わせが来た

対応フロー（シンプル版）

1. 発生の認識と記録
   → いつ・誰が・何を・どのようなツールに入力したか

2. 影響範囲の確認
   → 該当データはどのような情報か（個人情報？機密情報？）
   → 何人分のデータが対象か

3. 社内：上長・コンプライアンス担当への報告
   → 24時間以内に口頭報告 → 48時間以内に書面報告

4. 法令上の報告（個人情報保護委員会）
   → 要配慮個人情報の漏洩、または1,000人超の漏洩、不正目的による漏洩等の場合は法定報告義務あり
   → 速報：概ね3〜5日以内
   → 確報：30日以内（不正アクセス等は60日以内）
   → 本人への通知も必要

5. 再発防止策の策定
   → なぜ起きたか（ヒューマンエラー・プロセス不備）
   → 具体的な対策（チェックリスト・権限設定の見直し等）

ここで補足。法令上の報告期限と社内手続きの期限は別物です。混同しないよう、社内のインシデント対応手順書では両方を明記しておくのが安全です。

6. セキュリティ設定のベストプラクティス

まとめ

この章で押さえたこと3点：

1. 要配慮個人情報・マイナンバーは原則渡さない。一般個人情報は仮名化してから渡す
2. NDAはAI利用の可否を確認。新規契約はAI利用条項を追加する
3. インシデント対応フローを事前に整備しておくことで、問題発生時の混乱を防ぐ

次章（最終章）では、よくある詰まりと、Claude Code とともに自走し続けるための継続学習の考え方を扱います。