Notiondesk Workspace MCP を Codex に接続します

ワークスペース MCP を Codex に接続して、ワークスペース情報を確認したり、Codex CLI または IDE 拡張機能からサポートされているアクションを実行したりできます。

Notiondesk はリモート MCP サーバーとして動作し、OAuth を使用して Notiondesk アカウントを認証します。

始める前に

確認する：

Workspace MCP は、少なくとも 1 つの Notiondesk ヘルプセンターで有効になっています。

接続したいNotiondeskワークスペースにサインインできます。

Codexはコンピュータにインストールされ、正常に動作しています。

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

Notiondesk MCP を Codex に追加します

走る：

これにより、Notiondesk Workspace MCPサーバーがCodex構成に追加されます。

Notiondesk で認証します

サーバーを追加したら、以下を実行してください。

ブラウザでNotiondesk OAuth認証ページが開きます。

それから：

codex mcp add notiondesk --url https://mcp.notiondesk.so/mcp

codex mcp login notiondesk

必要に応じてNotiondeskにサインインしてください。

正しいワークスペースが表示されていることを確認してください。

要求された権限を確認してください。

接続を承認してください。

コーデックスに戻る。

Notiondesk APIキー、パスワード、またはトークンを手動で追加する必要はありません。

認証はOAuthを通じて行われます。

接続を確認する

設定済みのMCPサーバーを確認してください。

notiondeskが表示され、有効になっていることを確認してください。

その後、Codexを起動できます。

読み取り専用のリクエストから始めます。

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

それでは、以下をお試しください。

読み取り専用のリクエストから始めると、アクションを実行する前に Codex が正しい Notiondesk ワークスペースに接続されていることを簡単に確認できます。

CodexのWorkspace MCPを使用する

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

例えば：

または：

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

利用可能なアクションは、あなたの Notiondesk ロールとアクセスできるヘルプセンターによって異なります。

Codex IDE拡張機能のNotiondesk MCPを使用してください。

Codexは、CLIとサポートされているIDE統合の間でMCP構成を共有します。

Notiondesk を以下のように設定した後：

同じMCPサーバーは、Codex IDE拡張機能からも利用できます。

codex mcp list

codex

List the Notiondesk help centers I can access.

Show the sync status for my main help center.

Review the last 30 days of article feedback and analytics. Show me which documentation needs attention first.

Review recent chatbot conversations and identify repeated customer questions that are not covered well by our documentation.

Trigger a sync for the onboarding collection.

codex mcp add notiondesk --url https://mcp.notiondesk.so/mcp

サーバーを追加した時点で既に拡張機能が開いていた場合、Notiondesk が表示されない場合は、拡張機能を再読み込みしてください。

認証された各 Notiondesk 接続は、引き続きあなたのワークスペースの権限に従います。

Notiondesk を手動で設定します

Codex は MCP の設定を以下の場所に保存します。

Notiondesk は、以下の方法で手動で設定できます。

設定を保存した後、以下の方法で認証してください。

codex mcp add を使用する方が、通常は設定を手動で編集するよりも簡単です。

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

1 つの Codex 接続で、複数の Notiondesk ヘルプセンターにアクセスできます。

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

~/.codex/config.toml

[mcp_servers.notiondesk]
url = "https://mcp.notiondesk.so/mcp"

codex mcp login notiondesk

Workspace MCP が有効になっています。

あなたのNotiondeskアカウントはこれにアクセスできます

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

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

権限

Workspace MCP は、OAuth 認証時に使用された Notiondesk アカウントの権限に従います。

例えば：

Check the French translation status for the Developer Docs help center.

閲覧者はサポートされている読み取り専用情報にアクセスできます

エディターはサポートされている管理アクションを実行できます

管理者とワークスペースの所有者は、追加の管理アクションにアクセスできます。

Notiondesk を Codex に接続しても、アカウントに追加の Notiondesk 権限は付与されません。

トラブルシューティング

Notiondesk は Codex には表示されません

走る：

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

そうでない場合は、サーバーを再度追加してください。

codex mcp list

codex mcp add notiondesk --url https://mcp.notiondesk.so/mcp

Notiondesk は設定されていますが、認証されていません。

走る：

MCPサーバーの追加とOAuth認証の完了は、別々の手順です。

codex mcp login notiondesk

OAuth認証が開かない

Workspace MCPのURLが以下のとおりであることを確認してください。

その後、再試行してください。

Workspace MCP URLに/sseを追加しないでください。

https://mcp.notiondesk.so/mcp

codex mcp login notiondesk

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

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

そのヘルプセンターでは、Workspace MCPが有効になっています。

あなたの Notiondesk アカウントはこれにアクセスできます。

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

一部の Notiondesk ツールは利用できません

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

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

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

サーバーは`codex mcp list`に表示されますが、セッションでは利用できません。

MCPサーバーの設定後、新しいCodexセッションを開始してください。

IDE拡張機能を使用している場合は、MCPの設定を変更した後、拡張機能を再読み込みしてください。

Notiondesk MCP を削除します

Codexから接続を削除するには、インストールされているCodexのバージョンで利用可能なMCP管理コマンドを使用してください。

また、以下の場所から notiondesk エントリを削除することもできます。

Codex接続を削除しても、NotiondeskのWorkspace MCPは無効にならず、他のAIクライアントやチームメイトにも影響はありません。

~/.codex/config.toml

目次