Notiondesk Workspace MCP は、リモート MCP サーバーとOAuth 認証をサポートする互換性のある AI クライアントに接続できます。
MCP クライアントに専用の Notiondesk インストール ガイドがない場合は、このガイドを使用してください。
始める前に
確認する:
- Workspace MCP は、少なくとも 1 つの Notiondesk ヘルプ センターで有効になっています。
- 接続したいNotiondeskワークスペースにサインインできます。
- お使いのMCPクライアントは、リモートHTTP MCPサーバーをサポートしています。
- お使いのMCPクライアントはOAuth認証をサポートしています。
Workspace MCP がまだ有効になっていない場合は、 Notiondesk の Workspace MCP の有効化を参照してください。
接続の詳細
MCPクライアントにNotiondeskを追加する際は、以下の詳細情報を使用してください。
URLに/sseを追加しないでください。
Workspace MCPエンドポイントは次のとおりです。
MCPサーバーを追加する
AIクライアントのMCPまたはコネクタ設定を開きます。
具体的なインターフェースはクライアントによって異なりますが、通常は以下の手順が必要です。
Name: Notiondesk MCP
URL: https://mcp.notiondesk.so/mcp
Authentication: OAuthhttps://mcp.notiondesk.so/mcp- 新しいリモート MCP サーバーを追加する
- 名前として「Notiondesk MCP」と入力してください。
- サーバーURLとして
https://mcp.notiondesk.so/mcpを入力してください。
- クライアントが認証方法を要求した場合は、OAuth認証を選択してください。
- サーバーを保存または接続する
MCPクライアントが設定インターフェースではなく設定ファイルを使用している場合は、同じURLを使用してNotiondeskをリモートHTTP MCPサーバーとして追加してください。
正確な設定形式については、クライアントのMCPドキュメントを参照してください。
Notiondesk で認証します
サーバーを追加したら、接続または認証フローを開始します。
クライアントはブラウザでNotiondeskを開く必要があります。
それから:
- 必要に応じてNotiondeskにサインインしてください。
- 正しいワークスペースが表示されていることを確認してください。
- 要求された権限を確認してください
- 接続を承認する
- MCPクライアントに戻る
Workspace MCP は OAuth を使用するため、パスワードや API キーを MCP クライアントに手動でコピーする必要はありません。
接続を確認する
読み取り専用のリクエストから始めます。
期待していたヘルプセンターが表示されることを確認してください。
それでは、以下をお試しください。
次のような質問もできます。
読み取り専用のリクエストから始めることで、アクションを実行する前にクライアントが正しい Notiondesk ワークスペースに接続されていることを確認できます。
Workspace MCPを使用する
接続が完了すると、MCPクライアントはアカウントで利用可能なNotiondeskツールを使用できます。
例えば:
または:
Notiondesk ロールでサポートされている変更が許可されている場合は、次のようなアクションを要求することもできます。
クライアントがMCPツールを検出または起動する具体的な方法は、クライアントによって異なります。
権限
Workspace MCP は、OAuth 認証を完了した Notiondesk チームメイトの権限に従います。
別の MCP クライアント経由で接続しても、Notiondesk の権限は変更されません。
例えば:
List the Notiondesk help centers I can access.Show the sync status for my main help center.Show me the latest negative article feedback.Review our article feedback and analytics from the last 30 days. Show me which articles need attention first.Check the translation status for my main help center.Trigger a sync for the onboarding collection.- ビューアは、サポートされている読み取り専用アクセス権を受け取ります。
- エディターは、サポートされている管理操作を実行できます。
- 管理者またはワークスペースの所有者は、追加の管理操作にアクセスできます。
MCPクライアントは、あなたのNotiondeskアカウントが既に持っている以上のアクセス権を取得することはできません。
複数のヘルプセンターと連携する
Workspace MCPへの接続は1つで、複数のヘルプセンターにアクセスできます。
ヘルプセンターは、以下の場合に利用できます。
- Workspace MCP が有効になっています。
- あなたのNotiondeskアカウントはこれにアクセスできます
各ヘルプセンターごとに異なる Workspace MCP URL は必要ありません
同じエンドポイントが使用されます。
複数のヘルプセンターが利用可能な場合は、アシスタントに使用させたいヘルプセンターを指定してください。
例えば:
トラブルシューティング
https://mcp.notiondesk.so/mcpReview article feedback for the Developer Docs help center.クライアントがサーバーに接続できません
サーバーURLが正確に以下のとおりであることを確認してください。
使用しないでください:
またはエンドポイントに/sseを追加します。
クライアントはリモートMCPサーバーをサポートしている必要があります。
https://mcp.notiondesk.so/mcphttps://mcp.notiondesk.so/mcp/sse OAuth認証が開始されません
お使いのMCPクライアントは、リモートMCPサーバーへのOAuth認証をサポートしている必要があります。
クライアントがローカルMCPサーバー、APIキー、または静的ヘッダーのみをサポートしている場合、Workspace MCPと互換性がない可能性があります。
クライアントのMCPドキュメントを確認してください。
ヘルプセンターがありません
以下の点を確認してください。
- そのヘルプセンターでは、Workspace MCPが有効になっています。
- あなたの Notiondesk アカウントはこれにアクセスできます。
Workspace MCP は、お客様のアカウントがアクセスできないヘルプセンターを公開することはできません。
一部のツールは利用できません
利用可能な Workspace MCP ツールは、Notiondesk ロールによって異なります。
MCPクライアントによっては、使用できるツールに関して独自の制限を設けている場合もあります。
詳細については、 Workspace MCP の役割、権限、およびセキュリティを参照してください。
接続は機能しているが、ツールは自動的に使用されない。
MCPツールの選択方法は、AIクライアントによって異なります。
クライアントによっては、以下のことを要求する場合があります。
- 会話のためにMCPサーバーを有効にする
- コネクタを手動で選択する
- ツールの使用を有効にする
- 個々の行動を承認する
Notiondesk 接続がアクティブであるにもかかわらず、会話でそのツールが利用できない場合は、クライアントの MCP 設定を確認してください。