Visual Studio Code に Notiondesk Workspace MCP を接続すると、VS Code の AI ツールから Notiondesk ワークスペースにアクセスできます。
接続はNotiondeskから直接インストールすることも、リモートMCPサーバーを手動で設定することもできます。
Workspace MCP は OAuth を使用し、接続を承認した Notiondesk チームメイトの権限に従います。
始める前に
確認する:
- Workspace MCP は、少なくとも 1 つの Notiondesk ヘルプ センターで有効になっています。
- 接続したいNotiondeskワークスペースにサインインできます。
- あなたはMCPをサポートするバージョンのVS Codeを使用しています。
Workspace MCP がまだ有効になっていない場合は、 Notiondesk の Workspace MCP の有効化を参照してください。
ダッシュボードからNotiondeskに接続します。
最も簡単な設定はNotiondeskから始まります。
- Notiondesk ダッシュボードを開く
- Workspace MCPが有効になっているヘルプセンターを選択してください。
- 設定 → 一般に移動
- Workspace MCPセクションを探してください
- クライアントでインストールを開く
- VS Codeを選択します
- 「VS Codeに追加」をクリック
VS Code は Notiondesk MCP サーバーの詳細を開きます。
- サーバー名とURLを確認してください
- 「インストール」をクリック
- VS Code がサーバーを起動するように指示したら、起動してください。
- ブラウザでNotiondesk OAuth認証を完了してください。
認証が完了すると、VS Code で Notiondesk ツールが使用できるようになります。
Notiondesk MCP を手動で設定します
VS Code の mcp.json ファイルを使用して Workspace MCP を設定することもできます。
プロジェクト固有の接続を作成するには、以下を作成または開きます。
追加:
ファイルを保存します。
VS Codeは新しいMCPサーバーを検出するはずです。
Notiondesk をすべてのプロジェクトで利用できるようにする
Notiondesk を複数のプロジェクトで定期的に使用する場合は、単一のワークスペースではなく、VS Code のユーザープロファイルにサーバーを追加できます。
コマンドパレットを開いて、以下を実行します。
リモートHTTPサーバーを追加します。
設定対象として、ユーザープロファイルを選択してください。
ユーザーレベルのMCPサーバーは、VS Codeワークスペース全体で利用可能です。
Notiondesk MCPサーバーを起動します
コマンドパレットを開いて、以下を実行します。
notiondeskを選択してください。
そこから、サーバーの起動、停止、再起動、または検査を行うことができます。
VS Codeは、初めて接続を開始する際に、MCPサーバーを信頼するかどうかを確認するよう求める場合があります。
設定内容を確認し、承認して続行してください。
Notiondesk で認証します
VS Code が Notiondesk Workspace MCP に接続すると、OAuth 認証フローが開始されます。
.vscode/mcp.json{
"servers": {
"notiondesk": {
"type": "http",
"url": "https://mcp.notiondesk.so/mcp"
}
}
}MCP: Add Serverhttps://mcp.notiondesk.so/mcpMCP: List ServersNotiondesk がブラウザで開きます。
それから:
- 必要に応じてNotiondeskにサインインしてください。
- 正しいワークスペースが表示されていることを確認してください。
- 要求された権限を確認してください
- 接続を承認する
- VS Codeに戻る
接続を確認する
VS Codeで読み取り専用のリクエストから始めましょう。
想定していたヘルプセンターが返されることを確認してください。
それでは、以下をお試しください。
次のような質問もできます。
または:
VS Codeに変更を依頼する前に、まずは読み取り専用のリクエストから始めましょう。
VS Code から Workspace MCP を使用する
接続が完了すると、VS Code はリクエストに関連する利用可能な Notiondesk ツールを使用できます。
例えば:
あなたの Notiondesk ロールでサポートされているアクションが許可されている場合は、次の質問をすることもできます。
利用可能なツールは、あなたの役割とアクセスできるヘルプセンターによって異なります。
複数のヘルプセンターと連携する
同じ VS Code 接続で複数の 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 recent chatbot conversations and identify repeated customer questions.Review article feedback and help center analytics from the last 30 days. Show me which articles need attention first.Trigger a sync for the onboarding collection.- Workspace MCP が有効になっています。
- あなたの Notiondesk アカウントには、それにアクセスする権限があります。
ヘルプセンターごとに個別のMCP設定は必要ありません。
複数のヘルプセンターを利用する場合は、どのヘルプセンターを指しているのかを明記してください。
ワークスペースとユーザー設定の比較
Notiondesk MCP を 1 つのプロジェクトのみに設定する場合は、ワークスペース構成を使用してください。
VS Code ワークスペースすべてで Notiondesk MCP を使用したい場合は、ユーザー設定を使用してください。
ワークスペース構成がソース管理にコミットされている場合、他のチームメイトは同じ MCP サーバー定義を受け取ることができますが、各チームメイトは依然として自分の Notiondesk アカウントで認証する必要があります。
OAuth認証情報をチームメンバー間で共有しないでください。
トラブルシューティング
Check the translation status for the Developer Docs help center..vscode/mcp.json VS Code には Notiondesk が表示されません
コマンドパレットを開いて、以下を実行します。
notiondesk サーバーが表示されることを確認してください。
手動で設定した場合は、ファイルに以下の内容が含まれていることを確認してください。
MCP: List Servers{
"servers": {
"notiondesk": {
"type": "http",
"url": "https://mcp.notiondesk.so/mcp"
}
}
}サーバーが起動しません
走る:
Notiondesk サーバーを選択し、 「出力の表示」を選択して MCP ログを確認します。
同じメニューからサーバーを再起動することもできます。
MCP: List Servers OAuth認証が開始されません
サーバーURLが正確に以下のとおりであることを確認してください。
/sse を追加したり、URL を変更したりしないでください。
MCPの「サーバー一覧」からサーバーを再起動し、認証を再試行してください。
https://mcp.notiondesk.so/mcpヘルプセンターがありません
確認してください:
- Workspace MCP は、そのヘルプセンターで有効になっています。
- あなたのNotiondeskアカウントはこれにアクセスできます
VS Code は、認証を完了した Notiondesk チームメンバーが利用できないヘルプ センターにアクセスできません。
一部の Notiondesk ツールが見つかりません
Workspace MCP は、あなたの Notiondesk ロールに従います。
閲覧者は、編集者や管理者と同じ操作を行うことはできません。
詳細については、 Workspace MCP の役割、権限、およびセキュリティを参照してください。
VS Code から Notiondesk を切断します
VS Code から Notiondesk MCP サーバーを無効化または削除することで、サーバーを利用できなくなります。
走る:
Notiondesk サーバーを選択し、無効化または削除します。
手動で設定した場合は、mcp.json から notiondesk エントリを削除することもできます。
VS Code から接続を削除しても、Notiondesk の Workspace MCP は無効にならず、他の AI クライアントやチームメイトにも影響はありません。
MCP: List Servers