▮ この記事でわかること
APIってなに？
API / MCP FIRST LOOK
横文字が苦手でも、お金が絡むなら逃げられない。
APIとMCPは、最初に聞くとかなり眠い。でもAIに作業を任せるなら、課金、権限、APIキーの危険だけは先に見えるようにしておきたい。
API。
アルファベット3文字は世の中に無限に存在していて、APIもそのうちの一つだ。
横文字は覚えられない。
けど、これは覚えなきゃダメそうなやつだ。
理由は、お金が絡むから……らしい。
たぶん、この記事を読んでいる読者もAPIについて知らない。
知らないはず。
なので、俺がAIに質問しまくって、ふんわり理解した内容を伝えようと思う。
正確な技術解説ではなく、機械オンチ側の理解メモである。
APIは「他社サービスを使うための窓口」っぽい
AIに聞いたところ、APIは雑に言うとこうらしい。
APIとは、他社サービスを自分のアプリやサイトから使うための窓口。
この理解で、大きくは外れていないらしい。
やっかいなことに、APIは複数の意味を持つらしい。
話の脈絡で何を指しているのかが微妙に変わるっぽい。
日本語の雲と蜘蛛とか、雨と飴とか、同じ読みで違う意味的なやつっぽい。
その中で、今回俺が覚えなきゃいけないのが「他社サービスを使うための窓口」という意味でのAPIだった。
ここだけはちょっと大事。
「API＝他社AIサービスの窓口」ではない。
AIに限らず、地図、決済、天気、翻訳、検索など、いろんなサービスで使われる窓口である。
ただ、今の俺にとって一番怖いのは、AIや地図みたいな有料になることがある外部サービスの窓口としてのAPIである。
APIとは早い話、「条件を満たして、必要ならお金を払えば、自分のアプリやサイトから他社サービスが使える」って仕組み。
たぶん。
本当は、認証、利用制限、規約、料金体系などがあるらしいが、全部AIの担当だ。
そんなことより、このAPIってやつは知らないと勝手に課金されるリスクがあるらしい。
かなり低いっぽいけど。
俺はソシャゲは無課金で遊ぶタイプだ。
AIには課金してるけど、全自動マシーンを作りたいが全自動課金マシーンになってもらっては困る。
そのため、しぶしぶAPIについて調べてみることにした。
厳密な技術解説ではなく、機械オンチが事故らないための最低限の理解を目指す。
課金とAPIキーだけは先に警戒
食べログとGoogleマップで少し分かった
AIにさっぱりな俺には、やはりさっぱりなのだが、例題を聞くとちょっとイメージしやすい。
AIに「もっと分かる例で」と頼んだ。
すると、AIは俺を食いしん坊だと思ったのか、食べログのような飲食店サイトと地図の話で説明してくれた。
★ AIに聞いてみた
人間
ねぇ、APIってさ、結局どういうこと？ 全然ピンとこないんだけど。
AI
たとえば飲食店サイトで、お店の場所を地図で見られることがありますよね。あのような地図表示は、地図サービスのAPIで実現されている場合があります。
人間
……つまり、どゆこと？？
AI
飲食店サイトは地図会社ではありません。でも地図がないと不便です。そこで、地図サービスのAPIを使って、地図機能を借りるわけです。
ここまで言われて、俺は理解した。
たしかに。
たしかに、そうだ。
食べログみたいな飲食店サイトに地図がないと不便である。
でも、飲食店サイト側が1から世界地図を作るのは、さすがに無理がある。
そんなことを始めたら、飲食店サイトではなく地図会社になる。
さすがにアホすぎる。
そこで、すでに完成している地図サービスを借りる。
必要な分だけ使い、お金を払う。
それで、サイトを見る人は便利になる。
サービスを貸している会社にもお金が入る。
お互いwin-winである。
地図を借りる
便利になる。
この「窓口」がAPI。便利だが、使い方によっては料金が発生する。
……なるほど。
これがAPIか。
ちょっと面白くなってきた。
実は生活の裏側でめちゃくちゃ使われているらしい
ちょっと面白くなってAIにいろいろ聞いた。
すると、APIは私たちの生活の裏側でかなり使われているらしい。
予約サイト。
決済。
配送状況。
地図。
ログイン。
天気。
翻訳。
AI。
全部どこかで、何かと何かがつながっている。
APIは、裏側でサービス同士が手をつなぐための通路みたいなものだよ！ 普段は見えないけど、ないとかなり困るやつ。
AIは自動改札の話もしてくれた。
改札にタッチすると、一瞬でカードやスマホの情報が確認され、残高や定期券の情報が見られ、通っていいか判断される。
俺はこれを「APIの集合体」と原稿で書いたが、実際にAIにブログへ転載してもらった時に、しれっと「APIの集合体では雑すぎる」と直されていた。
もっと凄いらしい。
APIに限らず、いろんなシステム連携が一瞬で動いている、と考える方が安全らしい。
とにかく、世界最高峰レベルの技術水準を誇る自動改札。
そのほかにも、自販機とか、俺たちの身の周りのいろんなものでAPIってやつは使われているらしい。
今までそんなこと知らなくても生活できていた。
でも、AIを勉強して、なんだかちょっと社会の仕組みに詳しくなった気がした。
なぜこれが重要なのか
ここまでなら、まだ「へぇ」で終わる。
問題はここからである。
APIは、個人でも使える。
つまり、俺のこのブログでも、理屈の上ではAPIを使えばいろいろできる。
Googleマップのような地図を表示する。
天気情報を出す。
翻訳する。
検索する。
いろいろできる。
ただし、有料のAPIは使えばお金がかかる。
ここが重要である。
便利そうな外部サービスほど、使う前に料金、規約、APIキーの扱いを確認する。
便利な反面、勝手に使われると困る。
ここまで来てようやくこの記事の核心だが、CodexやClaude CodeはこのAPIまわりのコードや設定にも触れることがあるようである。
便利な反面、勝手に課金されるのは困りものである。
★ ここが怖い
人間
これって、AIに「このブログつくって！」って頼んだら、勝手に有料APIを入れられる可能性もあるってこと？
AI
権限や設定次第では、外部サービスを使うコードが追加される可能性はあります。だから、課金が発生するAPI利用は禁止事項として明示するのが安全です。
人間
やばいっしょ。勝手にGoogleマップみたいな有料機能を搭載されて、毎月請求されたらやばいよね？？ やばい。
そういうことである。
便利だが、怖い。
だから、CodexやClaude Codeに仕事を任せる際には、自由に仕事をさせていい領域と、禁止事項を持たせるのがよい。
つまりこうである。
「勝手にAPIで課金するな」
「APIキーを人の目につく場所に絶対に記載するな」
APIキーは、雑に言うとAPIを使うための合鍵である。
もっと雑に言うと、API版のクレジットカード暗証番号みたいなものだと思っておくと怖さが分かりやすい。
正確には違う。
でも、うっかり公開してはいけない重要情報という意味では、それくらいの警戒でちょうどいい。
勝手にAPIで課金するな。APIキーを人の目につく場所に書くな。
これをAIに明確に伝える。
それだけでかなり事故を防げる。
ここからはMCPの話をAIに任せる
本当はここからMCPという話もついでにしようと思った。
だが、上記の記事で満足した。
なので、ここからはざっくりプロットをAIに渡して代筆してもらうことにする。
きちんと投稿時はチェックするから、内容自体は問題ないはずだ。
では頼んだぞ、AIたち。
★ MCP説明をAIに丸投げする
人間
APIはちょっと分かった。じゃあMCPってなに？ またアルファベット3文字なんだけど。
AI
MCPはModel Context Protocolの略です。AIアプリが外部のデータやツールとつながるための共通規格です。
人間
共通規格って、ライトニングケーブルとタイプCの充電器みたいな話？
AI
人間側の理解としてはかなり近いです。ただし、充電器というより、AIと道具をつなぐための共通の差し込み口に近いです。
MCPは「AIと道具をつなぐ共通の差し込み口」
ここからAI主導で説明してもらう。
MCPは、Model Context Protocolの略である。
ざっくり言うと、AIアプリと外部ツールをつなぐための共通規格らしい。
地図、決済、天気、翻訳など、外部サービスを使う入口。
AIがファイル、ブラウザ、データなどの道具につながりやすくする考え方。
便利になるほど、やっていいこととダメなことを先に決める。
今まで、AIにいろんな道具を使わせようとすると、サービスごとに別々のつなぎ方が必要だった。
ファイルを読む道具。
ブラウザを操作する道具。
データベースを見る道具。
GitHubを見る道具。
社内ドキュメントを見る道具。
それぞれが別々の差し込み口だと、作る側も使う側も大変である。
そこで、共通のつなぎ方を決めよう、というのがMCPの考え方らしい。
スマホ充電器で言うType-Cのように、つなぎ方がそろうと、いろんな道具をAIが扱いやすくなる。
もちろん、Type-Cそのものではない。
電気を流す話でもない。
でも、人間側の理解としてはかなり助かる。
バラバラだった差し込み口を、なるべく共通化する。
そう考えると、MCPのイメージは少し見えてくる。
APIとMCPはどう違うのか
ここでまた混乱した。
APIも外部サービスとつながる窓口。
MCPもAIと外部ツールをつなぐ規格。
同じでは？
★ APIとMCPの違い
人間
ねぇ、APIも窓口で、MCPも差し込み口なら、結局同じじゃないの？
AI
近い部分はあります。APIはサービスごとの窓口です。MCPは、AIが複数の道具やデータにアクセスするための共通ルールとして考えると分かりやすいです。
ポンコツAI
APIはお店ごとの受付。MCPは、AIがいろんな受付を回りやすくする共通案内板、くらいの理解でいいかもだよ！
なるほど。
厳密にはもっといろいろある。
でも、俺の今の理解ではこうだ。
APIは、サービスを使うための窓口。
MCPは、AIがいろんなツールやデータとつながるための共通ルール。
どちらも便利。
どちらも強い。
そして、どちらも権限や課金や安全に注意が必要である。
MCPも便利だけど、自由にさせすぎるのは怖い
MCPを使うと、AIが外部の道具を使いやすくなる。
それは便利である。
たとえば、AIがファイルを読んだり、ブラウザを操作したり、データを見たりできる。
だが、便利ということは、できることが増えるということでもある。
できることが増えるなら、禁止事項も必要になる。
AIに道具を持たせるなら、何をしていいか、何をしちゃダメかもセットで決めよう！ 便利さと安全はセットだよ。
このブログで言うなら、こうである。
勝手に有料APIを使わない。
APIキーを公開しない。
本番ドメインのDNS切り替えを勝手にしない。
Cloudflareの有料プランに勝手にしない。
外部サービスに勝手に課金しない。
こういうルールを決めておく。
それが、AIに作業を任せるための安全ベルトになる。
今日の理解
APIもMCPも、まだ完全に理解したとは言えない。
でも、前よりはかなりマシになった。
APIもMCPもアルファベット3文字。何が何だか分からない。
APIは他社サービスの窓口。MCPはAIと道具をつなぐ共通規格。どちらも便利だが安全ルールが必要。
今日の理解はこうである。
- APIは、他社サービスを使うための窓口
- APIは便利だが、有料の場合は使用量や契約に応じてお金がかかる
- APIキーは外に出してはいけない重要情報
- MCPは、AIと外部ツールをつなぐための共通規格
- AIに道具を使わせるなら、禁止事項もセットで決める
完璧には分かっていない。
でも、危ないところは見えてきた。
つまり、今の俺に必要なのはこれである。
便利そうな横文字ほど、課金と権限を先に確認する。
これだけ覚えておけば、少なくとも知らないうちに財布が燃える確率は下がる。
たぶん。
いや、下がってほしい。
APIもMCPも、怖がるだけじゃなくて、ルールを決めて使えば味方になるよ！ でも課金と秘密情報だけは、ぜったい先に確認しよう。
