SpeakeasyでAPIをAIに開く方法|道具を選ぶ線と止め方

SpeakeasyでAPIをAIに開く方法|道具を選ぶ線と止め方

「顧客から、うちのサービスを自分たちのAIから直接使えるようにしてほしいと言われている」「社内システムのAPIをAIにつなげば、問い合わせの半分は片づくはずだと上から言われた」——自社のAPIを持つ会社のプロダクト担当や情シスから、2026年に入って急に増えた声です。公開されている数字を一つ見ておきます。API定義からAIの窓口を作る Speakeasy の公式ページによれば、同社の基盤で自社のAPIをAIに開いたデータベースの会社では、AIからの呼び出しが最初の月の約4,700回から5か月目には20万6,000回に増えました。APIをAIに開くと、呼び出しは人の想定を超える速さで増えます。だから、作る手順より先に、何を開き、誰が止めるかを決めておく必要があります。この記事では、Speakeasy を例に、自社のAPIからAIが呼べる窓口を自動で作って社員や顧客のAIに開くときの手順を、開くAPIの選別、道具の説明文、権限と鍵、利用者ごとの承認と停止、保守の持ち主、費用とやめ方の順に整理します。コードの書き方は扱いません。


カメ先生カメ先生

APIからAIの窓口を自動で作れると聞くと、ボタン一つで終わる話だと思われがちなんだ。でも本当は、自動で作られるのは「全部のAPIを道具として並べた初期案」で、何を残して何を外すかは人が決めるんだよ。


カメ子カメ子

自動で作れるのは下書きまでで、どの道具をAIに渡すかは別の判断、ということですか。


カメ先生カメ先生

そう。しかもAIは、道具の説明文を読んでどれを呼ぶかを決める。説明文が雑だと、削除の道具を検索の道具と取り違えることもある。だから開く範囲、説明文、誰の資格で呼ぶか、どこで止めるかを順に決める。


カメ子カメ子

作る作業より、開く前に決めることのほうが多いんですね。


この記事のポイント
  • Speakeasy はAPI定義(OpenAPI)から開発キットとAIの窓口(MCPサーバー)を作る米国の会社。2026年3月に、窓口の本人確認・権限・記録をまとめて扱う MCP Gateway を打ち出した
  • 自動で作られるのは全APIを並べた初期案。書き込み・削除・課金の道具は最初に外し、説明文を書き直し、読む道具と書く道具を分けてから開く
  • 誰の資格で呼ぶか、利用者ごとの承認と停止、APIが変わったときの作り直しの持ち主を、開く前に決める。どの道具を呼ぶかの最終判断をAIに任せきらない

あなたのWebサイトは、AIによる攻撃に耐えられますか?

AIを活用してWebサイト・Webサービスの脆弱性を診断し、発見した問題と推奨する修正方法をご報告します。

目次

Speakeasy とは:API定義から、開発キットとAIの窓口を作る会社

Speakeasy は米国の会社で、もともとは、APIの仕様を書いた定義ファイル(OpenAPI の形式)から、そのAPIを呼ぶための開発キット(SDK)を自動で作る製品で知られてきました。APIを持つ会社が、利用者向けの開発キットを言語ごとに手で書かずに済むようにする道具です。同じ定義ファイルから、AIが呼べる窓口(MCPサーバー)も作れるようにしたのが、ここ1〜2年の動きです。

MCPは、AIが外部の道具やデータを呼ぶための共通の取り決めです。API定義から作った窓口を社員や顧客のAIにつなぐと、AIはその窓口に並んだ道具(APIの一つひとつの操作)を選んで呼び出せるようになります。MCPそのものの考え方と、社内システムに触らせる範囲の一般的な決め方は別の記事で扱っているので、ここでは自社のAPIから窓口を自動で作り、それを開くときに固有に起きることに絞ります。

公式の説明では、作った窓口は Speakeasy が運営する基盤の上で動かすこともできますし、手元に書き出して自社で動かすこともできます。窓口のURLを、Claude や Cursor、Windsurf など、MCPに対応したAIの道具に登録すれば使い始められます。作る道具と、作った窓口を管理する仕組みの二つを持っている点が、この記事で取り上げる理由です。

2026年の動き:3月の MCP Gateway と、9月の窓口の束ね

2026年3月10日、Speakeasy は公式ブログで MCP Gateway を発表しました。説明では、社内のすべてのAIエージェントとすべてのMCPサーバーの間に置く一つの入り口で、本人確認(SSO)、方針、利用の見える化、監査をその入り口で扱います。同社はそれまで、MCPサーバーを作って動かすオープンソースの基盤を Gram という名前で出しており、発表はその基盤を企業向けの入り口として打ち出し直す位置づけでした。作るところから、配って管理するところへ重心を移したと読めます。

発表文は、MCPサーバーを作ること自体はいちばん難しい問題ではなく、本番で詰まるのは認証、見える化、配布だったと書いています。機能としては、API定義から作る、既存のサーバーを取り込む、既製の連携を載せる、という三つの作り方に加え、本人確認をまとめる仕組み、窓口・道具の束・道具の一つひとつの単位でかける役割別の権限、道具ごとの呼び出し件数や失敗率の計測が挙げられています。

9月3日には、複数のMCPサーバーを一つのURLにまとめて見せる仕組みを、すべての利用組織に提供したと公表しました。AIには道具の全一覧を最初から渡さず、「つながっている窓口の一覧」「窓口の道具の説明」「道具の詳しい入力の形」「道具の実行」の四つだけを渡し、必要になった分だけ読ませます。利用者が使えない窓口は一覧に出てこないため、同じURLでも人によって見える道具が変わります。公式のロードマップには、承認の依頼と許可の流れが出荷済み、利用者・やり取り・エージェントの単位でAIの利用を断ち切る停止の機能が「進行中」と載っています(2026年11月時点の確認)。

数字で見る:APIをAIに開くと、呼び出しは想定を超えて増える

冒頭で触れた事例をもう少し見ます。Speakeasy の公式ページによれば、データベースのクラウドサービスを提供する会社が2026年2月に同社の基盤で自社APIの窓口を公開し、AIからの呼び出しは最初の月の約4,700回から、5か月目には20万6,000回に増えました。公式ページは約44倍と書いています。人が画面から使う量ではなく、AIが繰り返し呼ぶ量で負荷と費用が決まることを示す数字です。

この数字から読み取るべきことは三つあります。一つ目は、AIは一つの依頼をこなすために同じ道具を何度も呼ぶことです。人なら一度の検索で済ませるところを、AIは条件を変えて何度も試します。二つ目は、呼び出しの増え方が読めないことです。利用者が増えたのか、一人のAIが同じ処理を回し続けているのかは、記録を見ないと分かりません。三つ目は、API側の上限や課金の設計が、人の利用を前提に作られていることが多い点です。

なお、この事例は Speakeasy 自身が公開している顧客の話で、条件の異なる自社にそのまま当てはまるわけではありません。ただ、呼び出しの上限と記録を、開く前に決めておく理由としては十分な材料です。以下の手順は、この前提で組み立てています。

手順の全体像:開く前に決める六つの工程

Speakeasy を使えば、API定義を読み込ませるだけで、すべての操作を道具として並べた窓口が作られます。公式の説明では、APIの操作が一つずつ道具になり、継続的な更新の仕組みから定義を送るたびに作り直されます。速く作れるぶん、何も決めずに開くことも簡単です。作る作業は数分でも、開く前の判断には数週間をかけるくらいの配分が現実的です。

STEP1
開くAPIを選ぶ

全操作の一覧から、AIに渡す操作を選ぶ。書き込み・削除・課金は最初の版から外す。

STEP2
道具の説明文を書き直す

AIが読む説明文を、いつ使い、いつ使わないかが分かる文に直す。

STEP3
読む道具と書く道具を分ける

読むだけの道具と、データを変える道具を分け、性質の目印を正しく付ける。

STEP4
誰の資格で呼ぶかを決める

利用者本人の資格で呼ぶのか、共通の鍵で呼ぶのかを決め、鍵の置き場所を決める。

STEP5
利用者ごとの見え方、承認、停止を用意する

部署や顧客ごとに見える道具を変え、確定の操作に承認をかけ、止める手順を決める。

STEP6
記録を取り、使われ方を見る

呼び出しの記録を取り、増え方と失敗の傾向を週次で見る。

この順番には理由があります。開くAPIを先に絞らないと、説明文を書き直す手間も、権限を設計する手間も、全操作の分だけ膨らみます。最初の版は「読む道具を数本だけ」にして、使われ方を見てから広げるのが、手戻りが最も少ない進め方です。

手順1:開くAPIを選ぶ。書き込み・削除・課金は最初に外す

Speakeasy の公式ドキュメントでは、API定義の操作ごとに「道具にしない」という印を付けると、その操作は窓口に出てきません。何も印を付けなければ、すべての操作が道具になります。既定は「全部開く」なので、外す判断を人が一つずつする必要があります。

操作の種類例最初の版での扱い理由
読むだけ顧客情報の参照、在庫の照会、注文状況の確認開く候補取り違えても元のデータは変わらない
作る下書きの作成、問い合わせの起票限定して開く作られた物を人が確認できれば被害は小さい
書き換える契約内容の更新、設定の変更外す誤った値で上書きすると元に戻しにくい
削除するデータの削除、利用者の無効化外す取り返しがつかない
お金が動く決済、返金、プランの変更、ポイント付与外すAIの誤りがそのまま損失になる
権限を変える管理者の追加、鍵の発行外す(以後も開かない)AIが自分の権限を広げられてしまう

表の判断は、操作の名前だけでは決まりません。名前が「取得」でも、内部で利用の記録を書き換えたり、外部へ通知を送ったりする操作があります。実務では、API担当者が操作ごとに「何が変わるか」を一行で書いた一覧を作り、変わるものがある操作は、名前にかかわらず書き込みとして扱うと決めておきます。

もう一つ外したいのが、使われていない古い操作や、内部向けの管理用の操作です。人向けのAPIでは目立たなかった操作でも、AIは一覧にあれば試します。最初の版で開く道具は、多くても十数本に抑えると、AIの選び間違いも、次の手順の手間も小さくなります。

手順2:道具の説明文を書き直す。AIは説明文で道具を選ぶ

公式ドキュメントによれば、道具の説明文は、何も手を入れなければAPI定義に書かれた操作の要約と説明がそのまま使われます。そしてこの説明文が、AIの道具とAIそのものに渡る文脈になります。AIは、説明文を読んでどの道具を呼ぶかを決めるので、人向けに書かれた短い要約のままでは、取り違えが起きます。公式ドキュメントも、見直して書き換えることを勧めています。

書き直すときに押さえる点は四つです。①いつ使う道具か、②いつ使ってはいけない道具か、③入力に何を渡すか(顧客番号なのか、メールアドレスなのか)、④結果に何が返るか、です。たとえば「注文を取得する」だけの説明では、AIは注文の一覧が欲しいときにも、1件の詳細が欲しいときにも同じ道具を呼びます。「注文番号が分かっているときに1件の詳細を返す。番号が分からないときは注文の検索の道具を使う」と書けば、選び間違いは減ります。

説明文は、AIへの命令文でもあります。説明文に「必ず」「すべて」といった強い言葉を入れると、AIはその道具を必要以上に呼ぶことがあります。逆に、顧客の個人情報が返る道具には「結果をそのまま利用者に見せず、必要な項目だけを答える」と書いておくと、出しすぎを抑えられます。説明文の変更は、APIの変更と同じように見直しを経て反映する決まりにします。

手順3:読む道具と書く道具を分け、性質の目印を正しく付ける

Speakeasy では、道具に「読む」「書く」といった区分を付け、窓口を立ち上げるときに読む区分の道具だけを載せる、といった使い分けができます。社員向けには読むだけの窓口、管理部門には書く道具も載せた窓口、と分けて開けます。最初の版は、読むだけの窓口から始めるのが安全です。

加えて、道具ごとに性質の目印を付けられます。公式ドキュメントでは、「読むだけか」の既定は「いいえ」、「元に戻せない変更をするか」の既定は「はい」、「同じ指示を繰り返しても結果が変わらないか」の既定は「いいえ」、「社外のものに触れるか」の既定は「はい」です。つまり、何も付けなければ、すべての道具が「データを壊しうる、社外に触れる道具」として申告されます。読むだけの道具に正しく目印を付けると、AIの道具の側が確認を出す回数を減らせます。

ここで誤解しやすいのは、目印はAIの道具への申告であって、操作を止める仕組みではないという点です。目印を「読むだけ」にしても、その道具が実際にデータを書き換えるなら書き換わります。逆に目印を正しく付けても、AIの道具が確認を出すかどうかは道具の側の作り次第です。止める仕組みは、手順1の「開かない」と、手順5の承認で用意します。

手順4:誰の資格で呼ぶか。認証と鍵の置き場所

公式の説明では、Speakeasy の窓口は、自社がすでに使っている本人確認の仕組みに認証を任せることも、Speakeasy に認証の役割を持たせることもできます。APIの鍵や合言葉の形の資格を直接受け付けることもできます。決めるべきは、AIが「利用者本人の資格」で呼ぶのか、「共通の資格」で呼ぶのかです。

利用者本人の資格で呼ぶ形なら、AIはその人がふだんの画面で見られるものしか見られません。顧客に開く場合は、顧客ごとの資格で呼ぶ形が前提になります。一方、共通の資格(一つの強い鍵)で呼ぶ形は作るのは楽ですが、AIを使う誰もが、その鍵の権限すべてを使えることになります。社員向けでも、部署をまたいで見せてはいけない情報があるなら、共通の資格は避けます。

鍵の置き場所も決めます。鍵を社員それぞれの端末の設定ファイルに書かせると、退職や異動のときに回収できません。窓口の側で資格を預かり、利用者は会社の本人確認でログインするだけにする形のほうが、鍵を配らずに済み、止めるときも一か所で済みます。鍵を発行する人、期限、使い回しの禁止を、APIの管理の決まりに書き足しておきます。

手順5:利用者ごとに見える道具を変え、承認と停止を用意する

Speakeasy の MCP Gateway は、窓口、道具の束、道具の一つひとつの単位で、役割ごとに使える範囲を分けられると説明しています。部署ごとに道具の一覧を分けることもでき、9月の束ねる仕組みでは、利用者が使えない窓口はそもそも一覧に出てきません。見せない道具は、AIが選び間違えることもないので、権限の設計はそのまま誤操作の予防になります。

承認は、確定にあたる操作に必ずかけます。公式のロードマップでは、承認の依頼と許可の流れ、方針に「確認を求める」「警告を出す」の型を加える機能が出荷済みとされています。最初の版で書き込みの道具を外していても、二つ目の版で開くときには、送信・更新・取り消しの前に人が内容を見る流れを入れます。承認する人の画面に、AIがなぜその操作を選んだのかを書かせる決まりにすると、中身を見ずに押す習慣を防げます。

停止の手順も、開く前に決めます。公式のロードマップでは、利用者・やり取り・エージェントの単位でAIの利用を断ち切る機能は、11月時点で「進行中」です。発表どおりに使えるようになるまでは、窓口そのものを止める手順、特定の利用者の資格を無効にする手順、API側で呼び出しを遮断する手順の三つを、誰が判断し誰が実行するかまで書いておきます。止める判断に迷う時間がいちばんの損失になります。

  • ロードマップの状態は随時変わります。停止や承認の機能を前提に計画を立てる場合は、契約前に提供元に現在の提供状況を確かめてください
  • AIが短いプログラムを書いて複数の道具を続けて呼ぶ使い方(公式は隔離した環境で動かすと説明)では、一回の依頼で多くの操作が走ります。承認をかける位置を、道具単位だけでなく依頼単位でも考えておきます

手順6:呼び出しの記録を取り、使われ方を見る

公式の説明では、窓口を通るすべての呼び出しが、どの利用者が、どの道具を、どのAIの道具から呼び、結果がどうだったかとともに記録されます。記録は外部の監視基盤に標準的な形式で流すこともできます。記録は、事故の調査のためだけでなく、開く範囲を見直す材料として使います。

週次で見る項目は、道具ごとの呼び出し件数、失敗の件数と種類、一人あたりの呼び出し件数の偏り、承認で却下された件数です。失敗が多い道具は、説明文が悪いか、入力の形が分かりにくいかのどちらかであることが多く、手順2に戻って説明文を直します。一人だけ呼び出しが突出している場合は、AIが同じ処理を繰り返している可能性があります。

公式のロードマップには、道具の定義が変わったことを検知する機能、道具ごと・窓口ごとの費用を追う機能も出荷済みとして載っています。こうした数字は、AIの使われ方を判断する材料であって、判断そのものではありません。道具を増やすか、外すかを決めるのは、記録を見たAPIの持ち主と利用部門です。

社員に開くか、顧客に開くかで変わること

同じ窓口の仕組みでも、開く相手によって決めることが変わります。社員に開く場合は、社内の権限と同じ線を窓口にも引けば足ります。顧客に開く場合は、顧客ごとの資格で呼ぶ形が必須になり、さらに利用規約、問い合わせの窓口、障害時の告知という、製品としての責任がついてきます。顧客に開く窓口は、自社の製品の一部として扱う必要があります。

顧客に開くときには、顧客のAIが自社の窓口をどう使うかを自社が見られないことも前提にします。顧客のAIが誤った操作をしても、それが顧客の指示によるものか、AIの取り違えかは、窓口の記録からは分かりません。そのため、顧客向けの最初の版は読むだけの道具に絞り、書き込みは自社の画面で顧客本人が確定する形を残すのが安全です。

公式の説明では、作った窓口を自社の独自ドメインのURLで公開することもできます。顧客に案内するURLを自社のドメインにしておくと、将来ほかの仕組みに移るときにも、顧客側の設定を変えてもらわずに済みます。やめ方の準備は、最初のURLを決める段階から始まっています。

保守の持ち主:APIが変わるたびに、道具も変わる

公式の説明では、API定義を継続的な更新の仕組みから送るたびに、新しい版の窓口が作られ、窓口は常に最新の版を出します。APIから操作を外せば、その道具も消えます。問題のある版は一手順で前の版に戻せます。APIを変えると、AIが使う道具も自動で変わるということです。

便利な反面、APIの担当者が人向けの変更のつもりで加えた新しい操作が、そのままAIにも開かれる可能性があります。手順1の「道具にしない」印や、手順2で書き直した説明文が、定義の更新で失われないかも確かめる必要があります。実務では、API定義の変更の見直しの項目に「AIの窓口への影響」を一行足し、新しい操作は既定で道具にしない運用にしておきます。

持ち主も決めます。API本体の持ち主はふつう開発部門ですが、AIの窓口の説明文と開く範囲は、利用部門の業務を知る人が見ないと決められません。窓口の持ち主を開発部門に置き、説明文と開く範囲の見直しには利用部門が必ず入る、という二者の分担にしておくと、どちらかが異動しても窓口が放置されにくくなります。

費用の増え方と、やめ方

Speakeasy の公開ページには無料で始める入口がありますが、窓口の基盤の料金の詳細は、公開ページでは確認できませんでした。費用を見積もるときは、①Speakeasy への支払い、②AIからの呼び出しで増えるAPI側の負荷と費用、③説明文の見直しや承認の運用にかかる人の手間、の三つに分けます。②と③は、窓口の利用が増えるほど比例して増えます。

②については、冒頭の事例のように呼び出しが短期間で何十倍にもなりうることを前提に、利用者ごと・道具ごとの呼び出しの上限をAPI側でも設けます。窓口の側の上限だけに頼らず、APIの側でも止められるようにしておくと、窓口の設定の誤りがそのまま費用の事故になるのを防げます。

やめ方は三つの段階で考えます。窓口だけを止める、Speakeasy の基盤から自社で動かす形に移す、AIへの開放そのものをやめる、です。公式の説明では、開発キットの作成ツールで、自社で動かせる単体の窓口を書き出せます。書き出した窓口を自社で動かす場合、本人確認や記録の仕組みは自社で用意し直す必要がある点を、移る前に見積もっておきます。

AIに判断させない範囲と、よくある失敗

API定義から窓口を自動で作れるようになると、「あとはAIがうまく選んでくれる」と考えたくなります。けれども、どの操作を開くか、誰の資格で呼ぶか、どこで承認をかけるかは、AIの性能では決まりません。AIが決めるのは「どの道具をどう呼ぶか」までで、「どの道具を渡すか」は人が決めるという線を、最初に関係者で確認しておきます。

  • API定義をそのまま読み込ませ、管理用や課金の操作まで含めた全操作を道具として開いてしまう
  • 人向けの短い要約のまま説明文を残し、AIが似た名前の道具を取り違える
  • 「読むだけ」の目印を付けたことで、操作が止まると思い込む
  • 共通の強い鍵で呼ぶ形にして、AIを使う全員がその鍵の権限を持ってしまう
  • APIの変更で新しい操作が増えたのに、AIの窓口にも開かれたことに誰も気づかない
  • 止める手順を決めないまま顧客に開き、誤った操作が続いても判断に時間がかかる

AIに根拠を書かせることも役に立ちます。承認の画面や記録に、AIがその道具を選んだ理由と、入力に使った値の出どころを残させると、取り違えの原因を後から追えます。根拠が書けない呼び出しは承認しない、という決まりは単純ですが効果があります。人が確認する範囲(確定の操作、顧客に見える結果、お金が動く操作)は、開く道具を増やすたびに見直します。

よくある質問

自社のAPIの定義ファイルが古い場合でも使えますか

定義ファイルが実際のAPIとずれていると、ずれた内容のまま道具が作られます。AIは定義どおりに呼ぶので、実際の動きと違えば失敗が増えます。窓口を作る前に、開く予定の操作だけでも定義ファイルが実際のAPIと一致しているかを確かめ、説明文を書き直す作業と一緒に直すのが近道です。

社員のPCに入っている個別のMCPサーバーの管理にも使えますか

MCP Gateway には社内のMCPの利用を一つの入り口にまとめる機能もありますが、この記事は自社のAPIから窓口を作って開く場面に絞っています。社員の端末に増えたサーバーの台帳や隔離の考え方は、別の観点の判断になるため、ここでは扱いません。

顧客向けに開く場合、最初に何を用意すべきですか

顧客ごとの資格で呼ぶ形、読むだけに絞った最初の版、利用規約への追記、問い合わせと障害時の連絡先、自社ドメインのURLの五つです。書き込みの道具は、顧客の使われ方を記録で確かめてから、承認の流れとあわせて開きます。

コードを書ける人がいなくても進められますか

窓口を作る作業そのものは定義ファイルの読み込みで進みますが、開く操作の選別、定義ファイルの修正、認証の設定、API側の上限の設定には、APIを理解している人が必要です。説明文の書き直しと開く範囲の判断は、業務を知る利用部門の人が担えます。

まとめ

Speakeasy は、API定義から開発キットとAIの窓口を作り、2026年には窓口の本人確認・権限・記録・承認をまとめて扱う方向へ製品を広げています。自動で作れるのは全APIを並べた初期案で、開く前に決めることのほうが多いのが実際です。書き込み・削除・課金・権限変更の操作は最初の版から外し、説明文をAIが選び間違えない文に書き直し、読む道具と書く道具を分ける。誰の資格で呼ぶかと鍵の置き場所を決め、利用者ごとに見える道具を変え、確定の操作には承認をかけ、止める手順を三つ用意する。APIの変更が窓口に及ぶ前提で保守の持ち主を決め、呼び出しの増え方を記録で見ながら、費用とやめ方まで先に描いておく。どの道具を渡すかを人が決め、AIには根拠を書かせることが、自社のAPIをAIに開くときの線引きです。

※本記事にはAIが活用されています。編集者が確認・編集し、可能な限り正確で最新の情報を提供するよう努めておりますが、情報の完全性、正確性、最新性、有用性等について保証するものではありません。本記事の内容に基づいて行動を取る場合は、読者ご自身の責任で行っていただくようお願いいたします。

あなたのWebサイトは、AIによる攻撃に耐えられますか?

AIを活用してWebサイト・Webサービスの脆弱性を診断し、発見した問題と推奨する修正方法をご報告します。

運営会社:株式会社デボノ

目次