MCPサーバーとワークフローのツール

MCPサーバーは、Ai FlowiのAI Flowi Workflowをクライアントや外部ツールと接続します。プロジェクトのMCP Serverは、選択したワークフローを呼び出し可能なツールとして公開します。MCP Serversの設定ではワークフロー用の外部接続を保存し、MCP Clientではコーディングエージェント用の設定を提供します。プロジェクトのMCP ServerのJSON画面には、SSEとStreamable HTTPの2種類のトランスポートがあります。外部MCP接続はSTDIOにも対応しています。

公開日 · 更新日

執筆：Ai Flowi · 技術レビュー：Janice Lee、Ai Flowi テクニカルサポート。

製品：Ai FlowiのAI Flowi Workflow · 作業：クライアントとワークフローのツールを接続 · コンポーネント：外部サーバーのツールを使うMCP Tools

使用する場面

プロジェクト内で選択したワークフローをMCPクライアントから利用できるようにするには、MCP Serverを使います。

外部サーバーのツールをワークフローで使うには、MCP ServersとMCP Toolsを使います。

AI Flowi Workflowのインスタンス上でフローを作成・実行するコーディングエージェント用の設定をコピーするには、MCP Clientを使います。

始める前に

  • 公開するプロジェクトとワークフローを選ぶか、外部サーバーの接続設定を入手します。
  • 通常のアカウントセッションを使ってください。サポートセッション中はMCPの設定が非表示になります。
  • APIキーは非公開のクライアント設定に保存し、ドキュメント上のプレースホルダーにはYOUR_API_KEYを使います。
  • プロジェクトの認証設定は、MCPのcomposer設定が有効な場合にのみ表示されます。

手順

1. MCP Server · Flows/Tools

プロジェクトのMCP Server画面を開き、Flows/ToolsのEdit Toolsを選択します。

ツール名と説明を確認し、このクライアントに使わせるワークフローだけを有効にします。

保存されるツール設定には、各ワークフローの名前、説明、有効かどうかの状態が含まれます。

2. Auth · Add Auth / Edit Auth

Authが表示されている場合は、Add AuthまたはEdit Authを選び、認証方式を確認します。

方式のラベルはNone、API Key、OAuthです。認証のないプロジェクトは、Authの概要にNone (public)と表示されます。

composer設定が無効な場合、ツールの選択を保存すると認証設定にはNoneが使われます。一方、生成されるクライアントのヘッダーは、インスタンスのログイン設定によって異なります。

プロジェクトのエンドポイントを共有する前に、生成された設定とアクセス権限を管理者と確認してください。

3. JSON · Transport

JSONを選択し、macOS/Linux、Windows、WSLのいずれかを選んでから、TransportでSSEまたはStreamable HTTPを選択します。

生成された設定をMCPクライアントにコピーし、YOUR_API_KEYがある箇所をすべて、非公開の環境で実際のキーに置き換えます。

JSON画面にGenerate API keyが表示され、キーが必要な場合は、その操作を使います。

Auto installを使うには、AI Flowi Workflowがローカルマシンで動作し、選択したクライアントが利用可能である必要があります。リモートのインスタンスにはJSONを使ってください。

選択したツールを無害な入力でテストし、クライアントが想定したワークフローの応答を受け取ることを確認します。

4. MCP Servers · Add MCP Server

設定からMCP Serversを開き、Add MCP Serverを選択します。

サーバー設定を貼り付ける場合はJSONを選択します。STDIOではName、Command、Arguments、Environment Variablesを設定し、Streamable HTTP/SSEではName、Streamable HTTP/SSE URL、Headers、Environment Variablesを設定します。

STDIOの場合は、設定したコマンドとその依存ソフトウェアが、AI Flowi Workflowを実行しているサーバーで利用できることを確認してください。

Add Serverを選び、保存した接続のツール数またはエラーメッセージを確認します。

接続を変更するにはEditとUpdate Serverを使います。Deleteを選ぶと、削除前に確認画面が開きます。

5. MCP Tools · MCP Server / Tool

ワークフローにMCP Toolsを追加し、保存済みのMCP ServerとToolを選択して、表示された入力項目を入力します。

コンポーネントを実行してResponseを確認します。選択したツールの結果がテーブルとして返されます。

HTTPS接続ではVerify SSL Certificateを有効にしておいてください。

コンポーネントのHeadersは、サーバー設定に保存されたヘッダーより優先されます。

6. MCP Client · Bob (IBM) / Claude Code

設定からMCP Clientを開き、Bob (IBM)またはClaude Codeを選択します。

Bob (IBM)ではSettings > MCPを開き、Edit Global MCPまたはEdit Project MCPを選択して、表示されたJSONを貼り付け、保存します。

Claude Codeでは、表示されたターミナルコマンドを使うか、~/.claude.jsonにJSON設定を追加します。

クライアント設定では、現在のインスタンスのアドレスをSERVER_URLに使い、API_KEYのプレースホルダーとしてYOUR_API_KEYを使います。

API Keysの設定でキーを生成し、非公開の設定内でプレースホルダーを置き換えます。

よくある間違い

  • プロジェクトのMCP Serverと、MCP Serversに保存された外部接続を混同すること。
  • リモートのインスタンスでもAuto installが使えると思い込むこと。
  • 実際のAPIキーを含む生成済み設定を共有すること。
  • Toolを選択する前に、サーバー接続によって実行が開始されると思い込むこと。

トラブルシューティング

MCP Serverの設定エラーが出る場合は、クライアント設定を生成する前に、プロジェクトのOAuth設定を修正してください。

MCP Serversでタイムアウトやエラーが出る場合は、サーバーのエラー詳細を確認し、接続設定を見直してください。

ツールが見つからない場合は、MCP Toolsで選択する前に、外部サーバーがツールを公開しているか確認してください。

ツール名や入力項目が古い場合は、Use Cached Serverを無効にして、最新のツールとサーバーの更新内容を取得してください。

NameとCommandが必須、またはNameとURLが必須というメッセージが出る場合は、サーバーを追加する前に必須項目を入力してください。

関連情報

ドキュメント · AI Flowi Workflow · ワークスペース · API Hub · 公開 · ワークフローをWebアプリとして公開 · 料金 · デモを予約