Codex

Your connector URL

https://atlier.ai/mcp

Fastest setup

Run this in a terminal:

codex mcp add projectdesk --url https://atlier.ai/mcp

Then authenticate projectdesk when Codex prompts you, using the same GitHub, Google, or Microsoft account you use for the desk.

Settings setup

1. Click your account name and choose Settings.
2. Open MCP servers, then choose Add server.
3. Choose Streamable HTTP (not STDIO).
4. Name it ProjectDesk, paste the connector URL into URL: https://atlier.ai/mcp — leave Bearer token env var and Headers empty (sign-in is OAuth, not a static token) — and save.
5. Click Authenticate, sign in with the same GitHub, Google, or Microsoft account you use for the desk, and approve the Project Desk authorization screen.
6. Use the permission settings you prefer in Codex.
7. Your desk may be empty at first — that's expected. Paste "Run atlier_project_scan first to get up to speed on Project Desk's capabilities and workflow, so you can help me use it. Then inspect the repositories in this workspace, including their setup and agent instructions, and show me a list of the projects worth tracking. Change nothing until I choose the projects I want to promote to Project Desk." If no repository is available, ask Codex to create and connect your first project.

Already added it once? Codex remembers your sign-in, so re-saving the same URL won't re-prompt — normally that's fine. But if the tools never appear afterward, that same "no re-prompt" is the tell that the sign-in went stale — see If your tools disappear below.

Check the connection before resetting it

A browser sign-in, an authorization, and tools in the current AI chat are separate facts. This page cannot inspect your AI app or prove its account matches the browser.

1. Confirm the browser account and intended desk. In Project Desk, check the signed-in identity and desk selector. Correct an account or desk mismatch before changing the connection.
2. Inspect the Project Desk tools in this AI conversation. A last verified use in Settings → Connected agents proves a past MCP call, not that every chat has loaded the tools. If they are callable, run atlier_project_scan with no arguments and select the intended desk explicitly before any write.
3. If tools are missing, start a new chat or task and check the client's MCP status. The cause can be client configuration, a disabled connector, permissions, authentication, or a transient connection problem; Project Desk cannot identify it from this page.
4. For Codex CLI, use codex mcp login projectdesk only when it reports authentication is required. Then start a new task so it loads the connection again.
5. Use Disconnect only as a targeted last step. In Settings → Connected agents, disconnect the affected client, then re-add the same URL https://atlier.ai/mcp. Do not create a renamed duplicate or reset a working client.

If a write result was uncertain or reports a conflict, read the project and issue again before retrying. Keep the original freshness guard; a readback tells you whether the first attempt committed.

Machine-readable setup

Connection facts are available at /setup/codex.json.