> ## 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

> Claude Desktop などの MCP クライアントを Flowglad に接続する手順。組織の URL 確認、テンプレート適用、データの扱いを説明。

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

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

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

`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/)に掲載されている料金セクションでは、Free、Plus、Max の各プランに MCP が含まれています。組織と Space の権限、OAuth の付与、および接続されたソースへのアクセスは引き続き適用されます。

外部のビジネスシステムへの Connection は、エージェントが使用できるようになる前に、Flowglad で構成し、対象の Space に公開しておく必要があります。[Connectors](/docs/ja-jp/connectors.md) と [Spaces](/docs/ja-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 の接続を確認し、アクセスできる Space を一覧表示するよう依頼してください。

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

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

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

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

クライアントのサポート状況はさまざまです。サーバーへの接続に成功しても、クライアントが Flowglad の Skill を自動的にインポートするとは限りません。Skill 検出の拡張機能と `skills.list` ツールは異なるインターフェースです。サポートされている検出とパッケージ管理の動作については、[Skills](/docs/ja-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 で利用可能な Connection を確認してください。 |
| 書き込みツールが利用できない、または拒否される | 必要な組織と Space の権限を確認してください。新たに付与された OAuth スコープが必要な場合は、再接続してください。 |
| 接続されたプロバイダーを読み取れない | その認可が有効であり、Connection が対象の Space に公開されていることを確認してください。 |
| Page またはファイルが見つからない | 正しい Space、その直接およびリンクされたアクセス、およびソースが引き続き利用可能であることを確認してください。 |
| 操作がジョブ ID またはラン ID を返す | 成功を報告したり再試行したりする前に、最終的なライフサイクルまたはランのステータスを確認してください。 |
| 書き込みがタイムアウトする | 再試行する前に、完了したかどうかを確認してください。一部の操作では、呼び出しのたびに新しいレコードが作成されたり、作業がキューに追加されたりします。 |
| アクセスの期限が切れる、または取り消される | OAuth を通じて再接続し、対象の組織と付与を確認してください。それでも再接続に失敗する場合は、サポートにお問い合わせください。 |

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

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


## Related topics

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


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