> ## Documentation Index
> Fetch the complete documentation index at: https://flowglad.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> MCP 対応のエージェントを Flowglad に接続します

MCP 対応のエージェントを Flowglad に接続すると、organization のビジネスナレッジや運用コンテキストを活用して作業できます。

コネクターでは、Page の検索と編集、ファイルや接続されたレコードの読み取り、Task の作成、再利用可能な Skill の管理、Automation の作成や実行を行えます。利用できるツールは、接続された identity、付与された権限、有効になっているプロダクト機能によって異なります。

## テンプレートを適用する

`tools/list` で `templates.apply` が利用可能な場合は、公開済みの `templateId` と既存の `spaceId` を指定すると、テンプレートのすべてのリソースを作成できます。Applications、Automations、通常の File のコピーはその Space に属し、Skills は organization に属します。ファイルは Space のルートに構成済みのファイル名で作成され、既存のファイルを上書きすることはありません。同じ名前の競合が発生するとそのコンポーネントは失敗しますが、独立したコンポーネントは続行できます。ファイルの完了とは、バイトとメタデータが永続的に保存されたことを意味し、インデックス作成の完了は待ちません。

必要に応じて、`connections` を `{ connector, connectionId }` オブジェクトの配列として指定します。プロバイダーごとに指定できる Connection は 1 つまでです。指定する Connection は、アクセス可能で互換性があり、必要な場合はすでに Space に割り当てられている必要があります。Connection を省略すると、リソースは構成待ちの状態になります。レスポンスでは、利用可能な Connection が推奨されます。利用できる Connection がない場合は、Connection の作成が推奨されます。

作成は単一の Trigger.dev タスクで依存関係の順に実行され、各コンポーネントの結果はタスクのメタデータと出力に記録されます。タスク全体の自動再試行は無効になっているため、失敗または中断したタスクによってリソースが部分的に残る場合があります。レスポンスは作成がキューに追加されたことを示し、予定されているコンポーネントと Connection の推奨を含みますが、リソースの作成が完了したことは保証しません。リソースを見つけて確認するには、各リソースの list/get ツールを使用してください。別のコンポーネントが失敗しても、正常に作成されたリソースは残ります。

テンプレートを適用しても、実行可能性の検証は後回しになり、リソースが有効化または実行されることはありません。apply を呼び出すたびに、再試行を含めて新しいコピーが作成されます。作成された内容を確認するには、リソースのツールを使用してください。

## 接続する前に

次のものが必要です:

* 使用する organization にアクセスできる Flowglad アカウント。
* organization の本番用 MCP URL。
* Streamable HTTP と OAuth によるリモート MCP サーバーをサポートするエージェントまたはクライアント。
* 目的の作業に必要な organization と Space の権限。
* 対象の Space で利用可能になっているソースの Connection やファイル。

[Flowglad のホームページ](https://www.flowglad.com/)に掲載されている料金セクションでは、Free、Plus、Max のすべてに MCP が含まれています。ただし、organization と Space の権限、OAuth の付与、接続されたソースへのアクセスは引き続き適用されます。

外部のビジネスシステムへの Connection は、エージェントが使用する前に、Flowglad で設定し、対象の Space に公開しておく必要があります。[Connectors](/docs/ja/connectors.md) と [Spaces](/docs/ja/spaces.md) を参照してください。

## organization の URL を確認する

本番用のコネクターは、organization 固有の URL を使用します:

```text theme={null}
https://dashboard.flowglad.com/api/mcp/orgs/{orgId}
```

`{orgId}` を実際の Flowglad の organization ID に置き換えてください。`org_` プレフィックスを含め、ID 全体をそのまま使用します。波括弧や架空の organization ID は入力しないでください。

Flowglad で **Settings** → **MCP** → **Add MCP Connection** → **Claude** → **Website** を開きます。そこに表示される organization の MCP URL をコピーします。リモート URL には **Website** の手順を使用してください。別の **Desktop app** タブには、コマンドラインでのセットアップ手順が記載されています。

これらの設定にアクセスできない場合は、Flowglad の管理者または[サポート](mailto:support@flowglad.com)にお問い合わせください。

このコネクターには organization の URL を使用してください。コネクション固有の URL では公開されるツールセットがより限定される場合があり、ここで説明する organization の URL と置き換えて使用することはできません。

## Claude Desktop から接続する

[Claude Desktop のセットアップ動画](https://youtu.be/6qqSnrqDJ2o)を見るか、以下の手順に従ってください。

[Flowglad を Claude Desktop に接続する方法](https://www.youtube.com/embed/6qqSnrqDJ2o)

Claude Desktop のカスタムコネクターのフローを使用して Flowglad を追加し、アカウントへのアクセスを許可します。

**1. カスタムコネクターのフォームを開きます。**

Claude Desktop で、**Customize** → **Connectors** → **+ Add** → **Add Custom Connector** に移動します。

**2. Flowglad コネクターを追加します。**

コネクター名として **Flowglad** を入力するか、別の名前を選択します。

URL フィールドに、organization の MCP URL 全体を貼り付けます。URL は [Settings > MCP](https://dashboard.flowglad.com/settings/mcp) からコピーできます。次のような形式になります: `https://dashboard.flowglad.com/api/mcp/orgs/org_...`

その他のコネクター設定は変更しないでください。**Add** を選択して続行します。バージョンによっては、Claude Desktop でこのボタンが **Continue** と表示される場合があります。

**3. Claude に Flowglad へのアクセスを許可します。**

接続フローを進めて、Claude が Flowglad アカウントにアクセスすることを許可します。求められたら、サインインし、目的の Flowglad の organization を確認し、要求されたアクセスを確認してから許可してください。

フローが完了したら、Claude Desktop に戻り、Flowglad の接続が利用可能であることを確認します。Claude に Flowglad の接続を確認し、アクセスできる Space を一覧表示するよう依頼してください。

OAuth Dynamic Client Registration が想定されている接続方法です。サーバーの URL にパスワード、アクセストークン、API キー、クライアントシークレットを追加しないでください。

この手順は、Flowglad をカスタムコネクターとして直接接続する方法を説明したものです。ディレクトリでの提供状況はこれとは別です。

## 他の MCP クライアントを接続する

同じ organization の URL を、リモートの Streamable HTTP MCP サーバーとして追加します。Flowglad アカウントでクライアントの OAuth フローを完了してから、organization と利用可能なツールを確認します。

クライアントのサポート状況はさまざまです。サーバーへの接続に成功しても、クライアントが Flowglad の Skill を自動的にインポートするとは限りません。Skill の検出拡張と `skills.list` ツールは別のインターフェースです。サポートされている検出とパッケージ管理の動作については、[Skills](/docs/ja/skills.md) を参照してください。

## データの取り扱い

Flowglad MCP の使用には、[Flowglad プライバシーポリシー](https://www.flowglad.com/privacy-policy)が適用されます。organization の管理者は、organization に対して行われたすべての MCP ツール呼び出しを [Settings > Audit](https://dashboard.flowglad.com/settings/audit) で確認できます。

## トラブルシューティング

| 症状 | 次のステップ |
| - | - |
| サインイン前に接続が失敗する | HTTPS の URL 全体と organization ID を確認します。クライアントが OAuth によるリモート MCP をサポートしていることを確認します。 |
| サインインは成功するが作業を利用できない | 選択した organization、Space のメンバーシップ、MCP の付与、Space で利用可能な Connection を確認します。 |
| 書き込みツールが利用できない、または拒否される | 必要な organization と Space の権限を確認します。新たに付与された OAuth スコープが必要な場合は再接続します。 |
| 接続されたプロバイダーを読み取れない | その認可が有効であり、Connection が対象の Space に公開されていることを確認します。 |
| Page やファイルが見つからない | 正しい Space であること、その直接アクセスとリンクされたアクセス、ソースが引き続き利用可能であることを確認します。 |
| 操作がジョブ ID または run ID を返す | 成功を報告したりリトライしたりする前に、最終的なライフサイクルまたは run のステータスを確認します。 |
| 書き込みがタイムアウトする | リトライする前に、完了していないかを確認します。操作によっては、呼び出すたびに新しいレコードを作成したり、作業をキューに追加したりします。 |
| アクセスの期限が切れた、または取り消された | OAuth で再接続し、目的の organization と付与を確認します。それでも再接続に失敗する場合は、サポートにお問い合わせください。 |

セキュリティに関する一般的な情報については、[Security](/docs/ja/security.md) と [Trust Center](https://trust.flowglad.com) をご覧ください。接続で問題が発生した場合は、[お問い合わせ](mailto:support@flowglad.com)ください。

サポートに連絡する際は、時刻、クライアント、影響を受けたツール、安全なエラーコード、利用可能であればリクエスト ID を含めてください。パスワード、ベアラートークン、Cookie、署名付きのアップロード/ダウンロード URL、顧客データは絶対に含めないでください。


## Related topics

- [Skills](/docs/ja/skills.md)
- [ようこそ](/docs/ja/agents/introduction.md)
- [Automations](/docs/ja/automations.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.