APIもMCPも分からなかった自分が、AIに仕事を任せる仕組みを整理してみた

API、MCP、スキル、ハーネス、Hooks。
CodexやClaude Code勉強していると、似た言葉が次々に出てきます。

一つ調べると、説明の中にまた知らない言葉がある。
いや、全部同じに見える。

横文字とアルファベットだらけ。
これ、自分だけですかね。

似た言葉が増えて、どれが何か分からなくなった

もう一つ、引っかかっていたことがあります。

自分はCodexに、同じ指示と確認を何回も打っていました。
毎回心配で、これが伝わっていたかなこれ喋んないといけないのかな？

面倒だとは感じていた。
ただ、なぜ毎回こうなるのかは、ただの言語化できていない。

そこで今日は、用語を一つずつ身近なものに置き換えてみることにしました。

APIは注文窓口、APIキーは人に見せない鍵

APIは、アプリ同士が「これをください」とやり取りする注文窓口です。
自分が作った画面からAIを呼び出すときも、この窓口を通ります。

その窓口で「この人の注文です」と示すのが、APIキー。

APIキーは、チャットに貼ったり、GitHubに載せたりしないのが基本です。公開した場所に残れば、他人に使われて、料金が自分に来るおそれもあります。

鍵を玄関の外に置くのと同じだ。

もう一つ気をつけたいのが、使いすぎです。
APIには、使った分だけ料金が増えるものがあります。

だから使う前に、月額料金、従量課金、無料枠の3つを確認する。

ただ、文章の指示だけには頼りません。
サービス側でも予算の上限や利用の通知を設定して、想定外の課金を防ぎます。

お金が出ていく場所は、自分が決める境界だ。
これを確認しないと、いつの間にかお金はどんどんどんなくなっていく。

MCPは、Codexと外の道具をつなぐLightningケーブル

MCPは、Codexと外の道具をつなぐ差し込み口、と自分は理解しています。決まった形のケーブルで、いろいろな道具につなげるイメージです。

料金は、MCPそのものより、つないだ先で変わります。
ここもAPIと同じで、つなぐ前に相手側の料金を見る。

スキルは手順書、ハーネスは仕事場

ここで、さっきの繰り返しとつながりました。

スキルは、決まった作業の手順書です。
「まず記事を読んでから始めて」を、一度書いて置いておけます。

ハーネスは、AIが働く仕事場。

AIそのものではなく。
AIをちゃんと働かせるための、周りに組む仕組み一式！！！

どこまで動いていいか、どこで止まる決まっています。
「このフォルダで作業して」は、本来ここで決めておく話でした。

自分は毎回、手順書と仕事場を口で説明していたことになる。

Hooksは、決まった瞬間に動くチェック係

Hooksは、「このタイミングが来たら、これを実行する」と決めておく仕組みです。たとえば、ファイルを保存したときや、作業を終えるとき。

「送る前に見せて」のような確認も、いくつかはここに任せられそうです。言い忘れても動く。

ここが大きい。

コミットとプッシュは、作業の足跡を残すこと

コミットは、「ここまでやった」と記録をつけること。
プッシュは、その記録をGitHubへ送ることです。

AIに任せる作業が増えるほど、何が変わったのかをあとから追えることが大事になります。記録があれば、おかしくなったときに戻れる。

任せた後に、自分が確かめるための足跡だ。

全部「AIに仕事を任せる仕組み」だった

一つずつ置き換えてみて、やっとつながりました。

APIとMCPは、外の道具とつなぐ。
スキルとハーネスは、働き方を決める。
Hooksは、確認を自動で回す。
コミットとプッシュは、任せた後の記録を残す。

どれも、人が毎回やらなくていい作業を、AIに任せるための仕組みでした。

じゃあ、人は何を決めるのか。
自分は3つに絞りました。

途中の進め方は、AIに提案してほしい。

毎回の指示と確認を、仕組みに置き換える

同じ指示を打つたびに、時間もトークンも減っていきます。

繰り返していたのは、手順書も仕事場も決めないまま、毎回口で渡していたからでした。

だから次は、始め・ゴール・危ない境界だけ決めて、途中はAIに提案させてみます。

似た言葉を覚えるより先に、自分が何を繰り返しているのかを見る。
今日の勉強の出発点は、そこでした。