> ## 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 に接続すると、組織のビジネスナレッジや業務のコンテキストを活用して作業できます。

コネクターでは、Pages の検索と編集、ファイルや接続済みレコードの読み取り、Tasks の作成、再利用可能な Skills の管理、Automations の作成と実行が行えます。利用できるツールは、接続されたアイデンティティ、付与された権限、有効になっているプロダクト機能によって異なります。

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

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

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

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

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

## 接続する前に

次のものが必要です。

* 使用したい組織へのアクセス権を持つ Flowglad アカウント。
* 組織の本番環境の MCP URL。
* Streamable HTTP と OAuth によるリモート MCP サーバーをサポートするエージェントまたはクライアント。
* 目的の作業に必要な組織と Space の権限。
* 関連する Space ですでに利用可能なソースの Connection またはファイル。

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

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

## 組織の URL を確認する

本番環境のコネクターでは、組織固有の URL を使用します。

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

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

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

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

このコネクターには組織の URL を使用してください。接続固有の URL では公開されるツールが限定される場合があり、ここで説明する組織の 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 フィールドに組織の 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 の組織を確認し、承認する前に要求されたアクセス内容を確認してください。

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

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

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

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

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

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

## データの取り扱い

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

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

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

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

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


## Related topics

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


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