- SUCCESS
- DATA
- ERROR
- HUMAN
すぐに答え
AIはどうやってカスタムAPIコールを行うのですか?
AIは execute_proxy ツールを使用して、外部サービスへの架け橋となります。指示を直接ターゲットのエンドポイントに送信するため、標準的なツールセットにはないアクションも実行可能です。これにより、APIにアクセスできるあらゆるサービスへエージェントの機能を拡張できます。
リクエストの結果について
リクエストの送信先と挙動
接続に関する複雑な処理は、プロキシがすべて引き受けます。
SUCCESS
APIの直接実行
エージェントがプロキシ経由でリクエストを送信します。対象サービスがそれを処理し、生のレスポンスをチャットに返します。
DATA
レスポンスの解析
AIがサービスから返されたJSONやテキストを読み取ります。そのデータを解釈して、質問への回答やワークフローの更新を行います。
ERROR
エラーハンドリング
エンドポイントが400または500エラーを返した場合、AIはステータスコードを認識します。これにより、リクエストが失敗した具体的な理由を説明できます。
HUMAN
ユーザーによる介入
特定の認証ヘッダーや、AIでは構築が困難な複雑なペイロードが必要な場合は、ユーザーが詳細情報を入力する必要があります。
ワークフロー
リクエスト実行時のAIの動き
エージェントは自然言語を構造化されたネットワークコールへと変換します。
ペイロードの構築
エージェントがリクエスト内容を確認し、対象サービスに必要なJSONボディやクエリパラメータを組み立てます。
execute_proxyリクエストのルーティング
エージェントはプロキシを使用し、指定された特定のダウンストリームURLへ整形済みのリクエストを送信します。
execute_proxyレスポンスの受信
プロキシがサービスからの受信データをキャッチし、エージェントに渡します。
execute_proxy結果の解釈
エージェントは返されたデータを読み取り、アクションが成功したかの確認や、次のタスクに必要な値の抽出を行います。
execute_proxy
試してみる
以下のプロンプトをコピーして開始してください。
これらのプロンプトを使用して、最初のプロキシリクエストを実行できます。
出発点
これらはテンプレートです。実際のサービスに合わせて、URLや特定のエンドポイントの詳細を書き換えて使用してください。
Apideck Connector
準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。
https://edge.vinkius.com/vk_preview_MpGMxZoRVWX3REjmQhhD471gARHPWqqryFlLYdNg/mcpClaude Desktop
以下の手順で数秒で接続できます。
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — Apideck capabilities are ready to use.
{
"mcpServers": {
"apideck-mcp": {
"url": "https://edge.vinkius.com/vk_preview_MpGMxZoRVWX3REjmQhhD471gARHPWqqryFlLYdNg/mcp"
}
}
}Use execute_proxy to send a POST request to https://api.service.com/v1/users with this JSON body: {"name": "Alex"}
Check the status of the order at https://api.store.com/orders/12345 using a GET request.
Update the record at https://api.crm.io/contacts/987 by sending a PATCH request with the new email address.
Call the endpoint at https://api.weather.com/current to get the temperature for New York.
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
ここから始める
Apideckを一度接続すれば、あとは指示するだけです。
Vinkiusのダッシュボードからアカウントを連携するだけです。認証情報は暗号化されて保持されるため、お好みのクライアントですぐにリクエストを開始できます。
ApideckをAIに接続するFAQ
動作に関する詳細
- 01
AIは好きなようにAPIコールを行えますか?
AIは execute_proxy ツールを通じてのみコールを行えます。実行できるのは、あなたが指示したエンドポイントとメソッドに限定されます。
- 02
AIは私のAPIキーを保存しますか?
いいえ。認証情報や機密性の高いヘッダーは接続を通じて安全に管理され、AIはプロキシコールを実行するためだけにそれらを使用します。
- 03
AIはサービス内のデータを削除できますか?
特定のエンドポイントに対して明示的に削除を指示した場合のみ、AIは DELETE リクエストを実行できます。AIが自律的に破壊的なアクションを行うことはありません。
- 04
APIが複雑なOAuthフローを必要とする場合はどうなりますか?
実行自体はプロキシが処理しますが、エージェントがエンドポイントにアクセスするために必要な権限を持てるよう、事前に接続を確立しておく必要があります。
- 05
AIはセキュリティプロトコルを回避できますか?
いいえ。プロキシは対象サービスの認証およびセキュリティ要件を遵守します。サービス側がリクエストを拒否した場合、AIが強制的に実行することはできません。
Apideckについて他に質問がありますか?コネクターのページで詳細を確認できます。 Apideckコネクターの全機能を見る
『Apideck』を Claude、Cursor、ChatGPT などに接続
