これは何?(3行で)
1API=アプリ同士の「受付窓口」。人間が画面を操作する代わりに、プログラムが決まった形で"注文"を出し、"結果"を受け取るための入り口です。
2APIキー=その窓口を使うための「あなた専用の合鍵(=身分証)」。誰が注文したか・料金を誰に請求するかを示すもの。だから他人に渡してはいけません。
3鍵が漏れると、他人に勝手に使われてお金を請求されます。だから「gitに上げない・チャットに貼らない・上限を設定する」——守り方が大切(最後の章+専用教材へ橋渡し)。
APIとは?(受付窓口のたとえ)
レストランを思い浮かべてください。あなた(お客)は厨房に直接入りません。ウェイター(窓口)にメニューから注文を伝え、料理を受け取ります。厨房の中身を知らなくても、決まった注文の仕方さえ守れば食事ができます。
図|あなたは「厨房(中身)」に直接入らない。ウェイター(API)に決まった形で頼めば、決まった形で返ってくる——中身の作りを知らなくても使えるのがAPIの便利さ。
私たちが普段使う画面(ボタンやフォーム)は"人間用"の入り口。それに対してAPIは"プログラム用"の入り口です。同じ機能を、人はボタンで、プログラムはAPIで呼び出す——という関係になっています。
| やりたいこと | APIの例(イメージ) |
|---|---|
| 今日の天気を取ってくる | 天気予報サービスのAPIに「東京の天気は?」と聞くと、気温や降水確率がデータで返る |
| 住所から地図・緯度経度を出す | 地図サービスのAPIに住所を渡すと、位置情報が返る |
| AIに文章を書かせる/要約させる | AIサービス(Claude・Geminiなど)のAPIに文章を送ると、AIの回答が返る |
| メッセージを自動送信する | チャットサービスのAPIに「この文をこの部屋へ」と頼むと、投稿される |
つまりAPIは、自分の作った仕組みに"外部サービスの機能"を組み込むためのコンセントのようなもの。自動化ツールがいろいろなサービスと連携できるのは、各サービスがAPIという窓口を用意しているからです。
APIキーとは?(合鍵・身分証のたとえ)
窓口(API)は誰でも自由に使えるわけではありません。「あなたが誰か」を示す合鍵が必要です。それがAPIキー——多くはsk-xxxxxxxxxxxx... のような長い文字列です。
APIキーには、主に2つの役割があります。
- 本人確認(身分証):「この注文は"あなた"からのもの」と証明する。無関係な人が勝手に使えないようにする。
- 料金の請求先(会員証):「使った分の料金は"あなた"に請求」というひも付け。だから鍵が漏れると、他人の利用があなたの請求になります。
図|APIキーは1本の注文で「本人確認(身分証)」と「料金の請求先(会員証)」の2役をこなす。
だから鍵が他人に渡ると "あなたの名義で使われ、あなたに請求" される=パスワードと同じ扱いが必要。
もう1つの前提:鍵のほかに「送り先URL(エンドポイント)」も要る
APIを呼び出すには、実は2つが必要です。①送り先のURL(どこへ届けるか)と、②APIキー(誰が頼んだか)。教材のたとえで言うと——送り先URL=受付窓口の"住所"、APIキー=その窓口で見せる"合鍵"。住所へ、合鍵を持って行って、はじめて注文が通ります。
エンドポイント/host
あなた専用の鍵
図|「住所(送り先URL)」+「合鍵(APIキー)」の2点セットで、はじめて注文が届く。
| 使うもの | 送り先URL(住所)は? | あなたがやること |
|---|---|---|
| チャットAI (ブラウザ/アプリ) | 組み込み済み(見えない) | ログインするだけ |
| Claude Code / Cowork / Codex | 組み込み済み(見えない) | ログイン、または鍵を1回設定するだけ |
| 汎用の連携ツールなど (例:n8n) | 「host」欄などに自分で指定することがある | 鍵+送り先URLの両方を設定 |
「host/エンドポイントを自分で入れる」場面は、いろいろな相手先につなげる汎用ツールや、普段と違う入口・自前サーバーに向けるときだけ。ふだんのAIツールでは裏で自動的に使われているだけで、意識しなくてOKです。
もし「host/エンドポイントURL」を入れる欄に出会っても、URLを暗記する必要はありません。「〇〇(サービス名)のAPIエンドポイントを教えて」とAIに聞いて、返ってきたURLを貼る——実際、これで十分回ります(貼ったあとに正しく動くかだけ確認)。分からない用語は、そのままAIに聞くのが一番速いです。
サービスサイトから発行して使うまでの流れ
APIキーは、使いたいサービスの公式サイト(管理画面)で自分で発行します。サービスごとに画面は違いますが、流れはだいたい共通です。ここでは一般的な手順を追います。
- そのサービスにアカウント登録・ログインする。(例:AIサービスなら、その会社の開発者向けサイトにサインアップ)
- 管理画面(ダッシュボード)を開き、「API」「API keys」「開発者」などの設定へ行く。多くは「Settings(設定)」の中にあります。
- 「Create API key(新しいキーを作成)」を押す。用途がわかる名前(例:
my-automation)を付けておくと、後で管理しやすいです。 - 表示された鍵をその場でコピーする。※ここが最重要 → 下のHONEST参照。
- 鍵を
.env(ドットエンブ)という設定ファイルに保存する。コードに直接書かず、必ず別ファイルへ。控えの大元はパスワード金庫(Bitwardenなど)に入れておくと安心です。 - (多くの場合)支払い方法の登録・利用上限の設定をする。従量課金のサービスは、使用上限や予算アラートをここで必ずかけておきます(次章)。
- ツールやコードから、その鍵を使ってAPIを呼び出す。「この鍵の名義で、この注文を」と窓口に伝わり、結果が返ってきます。
sk-...abcd のように一部が隠れている)。その場で必ずコピーして保存してください。控えを取り忘れたら、見に行くのではなく作り直し(再発行)すればOKです(古い鍵は無効化)。
.env は「鍵や秘密を入れておく専用の箱」です。コードは「.env の中の鍵を読んで使う」形にしておくと、コード本体には鍵が書かれないので、うっかりGitHubに上げても鍵は流出しません(.env は上げない設定にする)。この具体的なやり方は AIの記憶と第二の脳のつくり方 のセキュリティ章にあります。
料金の仕組み(従量課金が基本)
APIの多くは「使った分だけ払う」従量課金です。タクシーのメーターと同じで、呼び出した回数や処理した量に応じて料金が増えます。
- 無料枠:多くのサービスに「毎月ここまでは無料」という枠があります。学習・お試しはまず無料枠で。
- 上限・アラートは必須:従量課金の鍵は、使用上限(上限額)と予算アラートを必ず設定します。設定を忘れると、ミスや鍵の漏えいで想定外の高額請求になることがあります。
- 止めたいときは無効化:使わなくなった鍵・不安な鍵は、管理画面ですぐ無効化(削除/再発行)できます。
なぜ厳重に守るのか&守り方の要点
APIキーは「あなたの名義+請求先」がひも付いた鍵。漏れると他人に使われてお金がかかる/サービスを悪用されるおそれがあります。守り方の"最低ライン"は、むずかしくありません。
| やること | なぜ |
|---|---|
| ① gitに上げない | .env に入れ、.gitignore で除外。GitHubへの流出を構造的に防ぐ(「git add .」を使わないのがコツ) |
| ② チャットに貼らない | AIチャットや相談窓口に鍵を貼らない。送った内容はサーバーを通る |
| ③ 上限・アラート | 従量課金の鍵は使用上限と予算アラートをかける。事故の被害を小さく |
| ④ 画面に映さない | 録画・画面共有・撮影に鍵を映り込ませない |
| ⑤ 大元は金庫へ | 控えはローカルの平文メモでなくパスワード金庫(Bitwardenなど)に。バックアップにもなる |
「AIに鍵を見せるか(deny封印)」「保管はローカルか金庫か」といった一段深い設計は、AIの記憶と第二の脳のつくり方 のSTEP4「セキュリティを強化する」にまとまっています。この入門を読んだあとの深掘りにどうぞ。
ちょっと寄り道:APIとMCPの違い
Claude Codeなどを使っているとMCP(エムシーピー)という言葉も出てきます。かんたんに言うと——
| API(直接) | MCP(コネクタ) | |
|---|---|---|
| イメージ | 鍵を自分で管理し、プログラムから窓口を直接たたく | AI(Claude等)に外部サービスを"標準の差込口"でつなぐ仕組み |
| 鍵の扱い | 自分で発行し .env で管理 | コネクタ側で認証(つないだ範囲がまるごと見えることに注意) |
| 向き | 自作ツール・自動化に組み込む | AIに「このサービスを操作していいよ」と許可してつなぐ |
ここでは「別物」とだけ押さえればOK。MCPの詳しい話は 非エンジニアのためのコマンド地図(/mcp の章)や Google DriveとClaude Codeの連携ガイド にあります。
◆各AIの"コネクタ"(呼び名が違うだけで、同じ概念)
この「つなぐだけで使えるコネクタ」は、Claudeだけのものではありません。ChatGPT・Geminiにも同じ仕組みがあり、呼び名が違うだけです(設定画面で Slack・Gmail・Drive・Notion などを「連携」するあの画面)。
| Claude | Gemini | ChatGPT | |
|---|---|---|---|
| 呼び名 | コネクタ (Connectors) | 接続済みアプリ(Connected Apps)/拡張機能(Extensions) | コネクタ(Connectors)+カスタムGPTのアクション |
| Google系 | Gmail・Drive・Calendar 等をつなぐ | Gmail・Drive・Calendar・YouTube・マップ等が最初から内蔵(オン/オフで切替) | Gmail・Drive・Calendar 等をつなぐ |
| 他社サービス | Slack・Notion・Atlassian 等 | Extensionsマーケットで Slack・Notion・Zoom・Trello 等(+MCP対応も拡大中) | GitHub・SharePoint・Dropbox・Box・Notion 等+MCPでカスタム連携(有料プラン中心) |
用語ミニ辞典
- API=エーピーアイ(Application Programming Interface)
- アプリ同士をつなぐ「受付窓口」。プログラムから決まった形で機能を呼び出して使えるようにした入り口。
- APIキー=エーピーアイキー
- その窓口を使うための"あなた専用の合鍵(身分証+会員証)"。実質パスワード。漏らさない。
- .env=ドットエンブ
- 鍵や秘密を入れておく専用の設定ファイル。コードに直書きせず、ここに入れてGitHubには上げない。
- 従量課金=じゅうりょうかきん
- 使った分だけ払う料金方式。上限・アラート設定が事故防止のカギ。
- 無効化/再発行=むこうか/さいはっこう
- 鍵を使えなくする/新しく作り直すこと。漏れたら即これ。古い鍵は止まる。
- MCP=エムシーピー
- AIに外部サービスをつなぐ標準のコネクタ。APIとは別物。つないだ範囲が広く見える点に注意。
まとめ
API=アプリ同士の受付窓口、APIキー=それを使うあなた専用の合鍵(=実質パスワード)。使うときは、サービスの管理画面で発行 → その場でコピー → .env に保存 → 上限を設定 → 呼び出す、という流れです。鍵は漏れるとお金と信用に直結するので、gitに上げない・チャットに貼らない・上限をかける・画面に映さない・大元は金庫へ——この最低ラインだけは必ず守ってください。深い守り方は 第二の脳 のセキュリティ章へ。
あわせて読みたい
AIの基礎(まず全体像をつかむ) … AIの入口の地図。APIがどこに位置するかが分かる。
AIの記憶と第二の脳のつくり方 … APIキーの"守り方"を一段深く(.env・deny封印・金庫・3つの問い)。
Google DriveとClaude Codeの連携ガイド … 「AIに見せた情報はどこへ行くか」とAPI/商用プランのデータ扱い。
Claudeの契約とアカウントの選び方 … API/Team/Enterpriseなど、料金と契約の考え方。
この教材の元ネタ
- 新規テーマ(このHTMLが初出。対応する単一カリキュラムMDは未作成)。API・APIキーの一般的な概念と、鍵発行〜利用の一般的な流れを非エンジニア向けに解説したもの。
- APIキーの守り方(.env/.gitignore/deny封印/パスワード金庫/使用上限)は、既存教材 second-brain.html のセキュリティ章(setup/claude-code:APIキーの守り方3つの軸/AIに見せた情報はどこへ行くか_envとAPIキー)と整合。
- APIとMCPの違いは、カリキュラム setup/claude-code:MCPとAPIの違い.md を土台にした要約。
- ※発行画面のボタン名や料金体系はサービスごとに異なるため、本教材は特定サービスに依存しない「一般的な流れ」として記載。実際に使う際は各サービスの公式サイト・料金ページで確認を。