Connector · MCP · connection guide

Connect Plotlay to your AI agent

The Plotlay connector lets Claude, ChatGPT or another AI agent work in your Plotlay projects as you: draw rooms, place fit-out, check the rules, price a job and make the documents. You need a Plotlay account (free is fine). The connector acts as you: it sees and changes only the projects you can.

The quick way: let your agent walk you through it

Help me connect Plotlay to you, then get started. Read https://www.getplotlay.com/agents/connect (plain text: https://www.getplotlay.com/agents/connect.md) and walk me through connecting the Plotlay connector step by step, for the app I'm using you in. If you can't open web pages: Plotlay's connector is a remote MCP server at https://app.plotlay.io/mcp, and I sign in to Plotlay when I connect it, so there is no key to copy. Tell me where to add a custom connector in this app. When it's connected, list my Plotlay projects and suggest a good first task.

Help me connect Plotlay to you, then get started. Read https://www.getplotlay.com/agents/connect (plain text: https://www.getplotlay.com/agents/connect.md) and walk me through connecting the Plotlay connector step by step, for the app I'm using you in. If you can't open web pages: Plotlay's connector is a remote MCP server at https://app.plotlay.io/mcp, and I sign in to Plotlay when I connect it, so there is no key to copy. Tell me where to add a custom connector in this app. When it's connected, help me put my floor plan on the map: ask for the address and the plan, start a project there, and tell me which steps I do in the Plotlay app myself.

Help me connect Plotlay to you, then get started. Read https://www.getplotlay.com/agents/connect (plain text: https://www.getplotlay.com/agents/connect.md) and walk me through connecting the Plotlay connector step by step, for the app I'm using you in. If you can't open web pages: Plotlay's connector is a remote MCP server at https://app.plotlay.io/mcp, and I sign in to Plotlay when I connect it, so there is no key to copy. Tell me where to add a custom connector in this app. When it's connected, help me price a job and make a quote: ask which project and rooms (or help me draw them first), estimate it with my rates, and show me the quote before anything is sent.

Or do it yourself: Claude · Claude Code · ChatGPT · Cursor, VS Code and other MCP clients · Check it works · Troubleshooting · Disconnect

Claude (claude.ai, the desktop app and the mobile app)

1. In Claude, open Settings, then Connectors, then Add custom connector. Custom connectors depend on your Claude plan; on a Team or Enterprise plan an owner may need to add it for the organisation first.
2. Name it Plotlay and paste the URL https://app.plotlay.io/mcp. Leave the advanced settings empty, then choose Add.
3. Choose Connect. Plotlay opens on Connect an AI agent: sign in (or make a free account), check who is asking, then choose Allow Claude.
4. Back in Claude, turn Plotlay on for the chat (the tools or search and tools menu under the message box). Connectors added on claude.ai also appear in the desktop and mobile apps.

Claude Code

1. In a terminal, run: claude mcp add --transport http plotlay https://app.plotlay.io/mcp
2. Start Claude Code, type /mcp, choose plotlay and then Authenticate. Your browser opens Plotlay: sign in and choose Allow.
3. No browser on that computer? In Plotlay choose Account, then AI agents, then + New agent key, and run the command it shows instead: claude mcp add --transport http plotlay https://app.plotlay.io/mcp --header "Authorization: Bearer YOUR_KEY"

ChatGPT

1. Custom MCP connectors in ChatGPT need developer mode, which is offered on some plans only, and the menu names change between versions. In ChatGPT open Settings, then Apps and Connectors (or Connectors), then Advanced settings, and turn on Developer mode.
2. Create a connector (or app) named Plotlay with the URL https://app.plotlay.io/mcp and OAuth as the authentication. Plotlay opens: sign in and choose Allow.
3. In a chat, choose Plotlay from the developer mode tools under the message box.

Cursor, VS Code and other MCP clients

1. Add a remote MCP server (streamable HTTP) with the URL https://app.plotlay.io/mcp. Clients that support OAuth open Plotlay to sign in; choose Allow.
2. Clients that can’t sign in: make a key in Plotlay (Account, AI agents, + New agent key) and send it as the header Authorization: Bearer YOUR_KEY. Keep the key secret: it acts as you.
3. For example, in Cursor’s mcp.json: { "mcpServers": { "plotlay": { "url": "https://app.plotlay.io/mcp" } } }

Check it works

1. Ask your agent: “list my Plotlay projects”. It answers with your projects (or says you have none yet) and a link to open each one.
2. Then try a small job, such as “start a blank plan called Test and draw a 4 by 3 metre bedroom”, and open the link it gives you.

If it doesn’t work

• The URL is https://app.plotlay.io/mcp, with /mcp on the end. The app address on its own (app.plotlay.io) won’t work.
• Plotlay never opened to sign in: check the connector was added as a remote MCP server (HTTP), not a local command, and that no key or header was entered where sign-in is expected.
• It says unauthorised or the key was revoked: remove the connector, add it again and sign in, or make a new key.
• It can’t see a project: it sees only what your account can. Projects kept only in a browser are not in your account until you sync them.
• Too many calls: each connection may make 120 calls a minute. Wait a minute and try again.
• Your Claude or ChatGPT plan doesn’t offer custom connectors: use Claude Code or another MCP client, or ask your workspace owner.
• Still failing: getplotlay.com/status shows whether the connector is up. Your agent can report a Plotlay problem for you with report_issue, and tells you what it sent; or raise a ticket at getplotlay.com/support.

Disconnect or revoke

• In Plotlay: Account (the round initial, top right), then AI agents. Every connection and key is listed with when it was last used; Revoke stops it straight away.
• In your agent: remove the Plotlay connector (Claude: Settings, Connectors; Claude Code: claude mcp remove plotlay).

For agents: this guide as plain text is at https://www.getplotlay.com/agents/connect.md. What the connector’s tools do is on Plotlay for AI agents. How to do each job by hand in the app is in Learn, and the connector’s get_help tool returns the same lessons.