Notiondesk Workspace MCP を Claude Code に接続します

ターミナルから Notiondesk Workspace MCP を Claude Code に接続し、OAuth で認証を行い、Claude Code から直接 Notiondesk ツールを使用します。

2 分で読めます

Notiondesk Workspace MCP を Claude Code に接続して、ワークスペース情報を確認したり、サポートされている Notiondesk アクションをターミナルから直接実行したりできます。

Claude Codeは、リモートHTTP MCPサーバーとしてNotiondeskに接続し、OAuthを介して認証を行います。

始める前に

確認する：

  • Workspace MCP は、少なくとも 1 つの Notiondesk ヘルプ センターで有効になっています。
  • 接続したいNotiondeskワークスペースにサインインできます。
  • Claude Codeはコンピュータにインストールされ、正常に動作しています。

Workspace MCP がまだ有効になっていない場合は、 Notiondesk の Workspace MCP の有効化を参照してください。

Claude CodeにNotiondesk MCPを追加します。

走る：

これにより、Notiondesk Workspace MCP サーバーが Claude Code に追加されます。

Notiondesk をすべてのプロジェクトで利用できるようにする

すべての Claude Code プロジェクトから Notiondesk MCP を使用したい場合は、ユーザー スコープで追加してください。

特定の開発環境でのみ接続を利用できるようにしたい場合は、プロジェクトスコープまたはローカルスコープを使用してください。

Notiondesk で認証します

サーバーを追加したら、Claude Codeを起動します。

次に以下を入力してください。

notiondeskサーバーを選択し、認証フローを開始します。

Claude Code はブラウザで Notiondesk を開きます。

それから：

claude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcp
claude mcp add --transport http --scope user notiondesk https://mcp.notiondesk.so/mcp
claude
/mcp
  1. 必要に応じてNotiondeskにサインインしてください。
  1. 正しいワークスペースが表示されていることを確認してください。
  1. 要求された権限を確認してください。
  1. 接続を承認してください。
  1. クロード・コードに戻る。

Claude Codeは接続用のOAuth認証情報を保存し、必要に応じて更新することができます。

MCPサーバーを確認する

ターミナルから設定済みのMCPサーバーを確認できます。

Notiondesk サーバーを検査することもできます。

次に、Claude Codeを起動し、以下のコマンドで接続をテストしてください。

期待していたヘルプセンターが表示されることを確認してください。

次に、以下を試してみてください。

読み取り専用のリクエストから始めることで、Claude Code が正しい Notiondesk ワークスペースに接続されていることを確認できます。

Claude Code の Notiondesk を使用してください

接続が完了すると、Claude Code はリクエストに関連する利用可能な Notiondesk ツールを使用できます。

例えば：

または：

あなたの Notiondesk ロールで変更が許可されている場合は、Claude Code にサポートされているアクションを実行するように依頼することもできます。

Claude Code が実行できる操作は、あなたのワークスペースの権限によって異なります。

複数のヘルプセンターと連携する

同じ Claude Code 接続で複数の Notiondesk ヘルプ センターにアクセスできます。

ヘルプセンターは、以下の場合に利用できます。

claude mcp list
claude mcp get notiondesk
List the Notiondesk help centers I can access.
Show the sync status for my main help center.
Review recent article feedback and search analytics. Show me which documentation needs attention first.
Review recent chatbot conversations and identify repeated questions that are not covered well by our help center.
Trigger a sync for the onboarding collection.
  • Workspace MCPが有効になっています。
  • あなたの Notiondesk アカウントはこれにアクセスできます。

各ヘルプセンターごとに個別のMCPサーバーを設定する必要はありません。

複数のヘルプセンターが利用可能な場合は、Claude Code が使用するヘルプセンターを指定してください。

例えば：

適切なクロード・コードのスコープを選択してください

Claude Codeは、MCPサーバーに対して様々なスコープをサポートしています。

ローカルな範囲

ローカルスコープがデフォルトです。

現在のプロジェクトで Notiondesk MCP のみが必要な場合に使用します。

プロジェクトの範囲

MCP 構成をプロジェクトの .mcp.json 構成を通じてチームメイトと共有する必要がある場合は、プロジェクトスコープを使用してください。

各チームメンバーは、引き続き各自の Notiondesk アカウントで認証を行います。

OAuth認証情報をチームメンバー間で共有しないでください。

ユーザー範囲

Notiondesk をコンピュータ上のすべての Claude Code プロジェクトで使用したい場合は、ユーザー スコープを使用してください。

Claude Code から Notiondesk を定期的に管理するほとんどの人にとって、ユーザー スコープが最も便利なオプションです。

権限

Workspace MCP は、OAuth 認証を完了した Notiondesk チームメイトの権限に従います。

例えば：

Check the French translation status for the Developer Docs help center.
claude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcp
claude mcp add --transport http --scope project notiondesk https://mcp.notiondesk.so/mcp
claude mcp add --transport http --scope user notiondesk https://mcp.notiondesk.so/mcp
  • ビューアはサポートされている読み取り専用ツールを使用できます
  • エディターはサポートされている管理アクションにアクセスできます
  • 管理者またはワークスペースの所有者は、追加の管理アクションにアクセスできます。

共有プロジェクトに Notiondesk MCP を追加しても、あるチームメイトの Notiondesk 権限が他の全員と共有されるわけではありません。

各チームメンバーは個別に認証を行う。

トラブルシューティング

Claude Code は Notiondesk MCP サーバーを見つけることができません

走る：

notiondeskが表示されていることを確認してください。

そうならない場合は、もう一度追加してください。

claude mcp list
claude mcp add --transport http notiondesk https://mcp.notiondesk.so/mcp

OAuth認証が開始されません

Claude Codeを開いて以下を入力してください。

Notiondesk サーバーを選択して認証を開始します。

ブラウザが自動的に開かない場合、Claude Codeは手動で開くことができるURLを提供する場合があります。

/mcp

Notiondesk サーバーは追加されましたが、認証されていません。

使用：

次に、Notiondesk サーバーを選択し、OAuth フローを完了します。

MCPサーバーの追加と、Notiondeskアカウントの認証は、別々の手順です。

/mcp

ヘルプセンターがありません

以下の点を確認してください。

  • Workspace MCP は、そのヘルプセンターで有効になっています。
  • あなたのNotiondeskアカウントはこれにアクセスできます

Claude Codeは、OAuth認証時に使用されたアカウントで利用できないヘルプセンターにアクセスすることはできません。

一部の操作は利用できません

Workspace MCP は、あなたの Notiondesk ロールに従います。

Claude Codeが情報を読み取ることはできても、特定のアクションを実行できない場合、アカウントに必要な権限がない可能性があります。

詳細については、 Workspace MCP の役割、権限、およびセキュリティを参照してください。

認証が機能しなくなりました

開ける：

Notiondesk サーバーを選択して、再度認証してください。

再接続する前に、MCPメニューから既存の認証情報を削除することもできます。

/mcp

Notiondesk MCP を削除します

Claude Codeからサーバーを削除するには：

Claude Code からサーバーを削除しても、Notiondesk の Workspace MCP は無効にならず、他の AI クライアントからの接続にも影響しません。

claude mcp remove notiondesk

関連する記事

このページは役に立ちましたか？