AIから外部APIを呼び出す方法：Convex MCPコネクターを活用する

エージェントがConvexアクションを呼び出すことで、外部サービスへアクセスします。これにより、Webhookの送信や通知、データベースのトランザクションとは切り離されたカスタムコードの実行が可能になります。実行結果はチャット画面に直接表示されます。

1. 01

   タスクの特定

   プロンプトを解析し、データベースを操作すべきか、外部サービスを利用すべきかを判断します。

   run_function
2. 02

   外部ロジックの実行

   サードパーティAPIへのアクセスが必要な場合、Convexアクションを実行してリクエストを送信します。

   run_action
3. 03

   データベースの更新

   データの変更が必要な場合、Convex関数を実行してレコードを更新します。

   run_function
4. 04

   結果の通知

   Convexの実行結果を受け取り、何が起きたのかをユーザーに伝えます。

   run_actionrun_function

Convex Connector

準備完了です。MCPクライアントを選択し、セットアップ手順に従ってください。

コネクタリンクhttps://edge.vinkius.com/vk_preview_MADGSG1GwcjX2nZFJX7QdDYmcBCtd1WoRLCUHsG9/mcpコピー

Claude Desktop

以下の手順で数秒で接続できます。

1. 1In Claude Desktop, open Settings → Connectors.
2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3. 3Click Add and start a new chat — Convex capabilities are ready to use.

設定 · claude_desktop_config.jsonコピー

{
  "mcpServers": {
    "convex-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_MADGSG1GwcjX2nZFJX7QdDYmcBCtd1WoRLCUHsG9/mcp"
    }
  }
}

• Claude
• ChatGPT
• Cursor
• VS Code
• Windsurf
• Claude Code
• JetBrains
• Cline

リンクをクリックして接続を承認してください。認証情報は安全に暗号化され、すぐにツールを使用できる状態になります。

• 01

  AIがデータベースのスキーマを変更することはありますか？

  いいえ。エージェントは、Convexのデプロイメントですでに定義されている特定の関数やアクションのみを実行できます。

• 02

  AIは自動的にAPIを呼び出しますか？

  いいえ。プロンプトの内容からアクションの実行が必要だと判断された場合にのみ、外部呼び出しが行われます。

• 03

  AIがデータベース全体を削除してしまうことはありますか？

  いいえ。エージェントの権限はマニフェストで提供された特定のツールに限定されています。明示的に定義されていない操作を行うことはできません。

• 04

  アクションを実行する前に、AIは許可を求めてくれますか？

  動作は使用しているクライアントの設定に依存しますが、特定のタスクに対してユーザーの承認を必須にするよう設定可能です。

• 05

  エージェントはどのConvexツールを使うべきか、どうやって判断していますか？

  エージェントは、ユーザーの自然言語によるリクエストを、Convexマニフェストに記載されたツールへとマッピングして判断します。

• Convexについてさらに詳しく知りたいですか？ Convex MCPコネクターの全機能を見る