Skip to main content

Connect an AI agent

doploy has a hosted MCP server at https://mcp.doploy.io/mcp/. Any AI client that speaks MCP can watch your builds, read test results and logs, query your Odoo data, and, if you allow it, deploy. You sign in with your doploy account in the browser. There are no tokens to copy.
Connected apps page in doploy settings

One login covers your projects, builds, logs and Odoo data.

Claude Code

Then, inside Claude Code, run /mcp, pick doploy and choose Authenticate. Your browser opens the consent screen below.

Codex CLI

Codex detects OAuth on the server and opens your browser the first time a doploy tool is used.

ChatGPT

  1. Turn on Developer mode: Settings → Connectors → Advanced settings → Developer mode.
  2. Settings → Connectors → Create.
  3. Name doploy, MCP server URL https://mcp.doploy.io/mcp/, authentication OAuth, then Create.
ChatGPT shows the doploy connector in the composer under Developer mode. Custom MCP connectors need a Plus or Pro plan on the web.

Cursor

Add the server to .cursor/mcp.json (project) or your global MCP config:
Cursor shows Needs login next to the server. Click it to sign in.

Claude Desktop and Claude.ai

Settings → Connectors → Add custom connector. Name it doploy and use https://mcp.doploy.io/mcp/ as the URL. Custom connectors need a Pro, Max, Team or Enterprise plan.

VS Code with Copilot

  1. Command Palette → MCP: Add ServerHTTP.
  2. URL https://mcp.doploy.io/mcp/, name doploy, choose Global or Workspace.
  3. Command Palette → MCP: List Servers → doploy → Start Server, then Allow the sign-in.
Or add it to .vscode/mcp.json:

Gemini CLI

Windsurf

Add to mcp_config.json:

Anything else

Any client that supports remote MCP servers with OAuth works. Point it at https://mcp.doploy.io/mcp/ and follow its sign-in prompt.

Terminal agents

Claude Code, Codex and similar tools also work with the CLI. doploy skill install teaches Claude Code when to use it. Whichever client you use, doploy asks the same three questions once:
doploy consent screen for an AI client

Access, permissions and project scope. All three can be changed later without reconnecting.

  1. Access. Your doploy account is the right choice for coding agents. It covers every project you belong to and the Odoo data on every connection you can reach. Odoo permissions still apply per connection.
  2. Permissions. Read only is the default. Read + deploy additionally lets the agent create dev branches, rebuild, restart, update modules and take backups. Production actions always ask the agent to confirm first.
  3. Projects. All projects, or only the ones you tick.
Every choice is editable afterwards in Settings → Connected apps, and changes apply on the agent’s next request. See Permissions and safety.

First things to try

  • “Why did the last build on feature/checkout fail?”
  • “Tail the Odoo log on staging and look for tracebacks.”
  • “How many open sales orders are in production?”
  • “Merge is done. Update the changed modules on staging and tell me when it finishes.”
The agent discovers the right tools on its own. The full list is in What agents can do.