Setup guide

Connect your AI assistant to Build Paperless

ChatGPT, Claude, Grok and Microsoft Copilot can all read your projects, schedule, defects and leads straight from Paperless. Setting one up takes about five minutes.

Before you start

Every assistant connects the same way. You give it one address, then sign in with your Paperless login.

1. Copy the server URL

Every assistant asks for this address.

https://www.buildpaperless.com.au/mcp

2. Choose your plan

Looking things up is free. To let your assistant make updates too, an admin chooses Starter in Settings, Integrations, AI and API access.

3. Sign in when asked

Use your normal Paperless email and password. You choose what the assistant can see, and it never sees more than you can.

Connect ChatGPT

You need: A paid ChatGPT plan (Plus, Pro, Business or Enterprise). On Business or Enterprise, a workspace admin may need to allow custom apps first.

  1. 1In ChatGPT, open Settings, then Apps (older versions call it Apps & Connectors).
  2. 2Open Advanced settings and switch on Developer mode.
  3. 3Choose Create (or Add app). Name it Build Paperless.
  4. 4Paste the server URL https://www.buildpaperless.com.au/mcp and set Authentication to OAuth.
  5. 5Tick that you trust the app, then choose Create.
  6. 6ChatGPT opens the Build Paperless sign-in page. Sign in with your normal Paperless login and choose what it can access.
  7. 7In a new chat, pick Build Paperless from the tools menu (the + button) and ask your question.

ChatGPT changes its menus from time to time. If a step looks different, look for the option to add a connector, app or MCP server and use the same server URL.

Connect Claude

You need: A Claude plan that allows custom connectors (Pro, Max, Team or Enterprise). On Team or Enterprise, an owner adds the connector once for the whole team.

  1. 1In Claude, open Settings, then Connectors.
  2. 2Choose Add custom connector.
  3. 3Name it Build Paperless and paste the server URL https://www.buildpaperless.com.au/mcp. Leave the advanced settings empty.
  4. 4Choose Add, then Connect.
  5. 5Sign in with your normal Paperless login and choose what Claude can access.
  6. 6In a new chat, check Build Paperless is switched on in the tools menu, then ask your question.

Claude changes its menus from time to time. If a step looks different, look for the option to add a connector, app or MCP server and use the same server URL.

Connect Grok

You need: A paid Grok plan that includes connectors.

  1. 1Go to grok.com/connectors (in the Grok mobile app, it is under Settings).
  2. 2Choose New connector, then Custom.
  3. 3Name it Build Paperless and paste the server URL https://www.buildpaperless.com.au/mcp.
  4. 4Sign in with your normal Paperless login when asked, and choose what Grok can access.
  5. 5In a new chat, switch Build Paperless on and ask your question.

Building your own tool on the xAI API instead? The xAI API cannot run a sign-in page, so it uses an API key. An admin creates one in Paperless under Settings, Integrations, AI and API access (Create an API key), then add the server URL as a remote MCP tool and pass the key as its authorization value. Keep the key somewhere safe: anyone holding it has the access you gave it.

Grok changes its menus from time to time. If a step looks different, look for the option to add a connector, app or MCP server and use the same server URL.

Connect Microsoft Copilot

You need: Microsoft Copilot Studio (copilotstudio.microsoft.com). Copilot in Microsoft 365 reaches Paperless through an agent you build in Copilot Studio, so someone with Copilot Studio access sets it up once. Your IT admin may need to allow custom connectors in your Microsoft environment.

  1. 1In Copilot Studio, create an agent (for example "Paperless assistant") or open an existing one.
  2. 2Open the Tools tab and choose Add a tool, then New tool, then Model Context Protocol.
  3. 3Enter the server name Build Paperless, a short description such as "Projects, schedule, defects and leads from Build Paperless", and the server URL https://www.buildpaperless.com.au/mcp.
  4. 4Under Authentication, choose OAuth 2.0, then Dynamic discovery. You do not need a client ID or secret.
  5. 5Choose Create. When asked for a connection, choose Create new connection and sign in with your normal Paperless login.
  6. 6Choose Add to agent. The Build Paperless tools now show on the agent.
  7. 7Test it in the Copilot Studio test pane, for example "Which of my projects are behind schedule?"
  8. 8To use it inside Teams and Microsoft 365 Copilot, open Channels, choose Teams and Microsoft 365 Copilot, and publish the agent.

Each person who uses the agent signs in to Paperless with their own login the first time, so they only see what their Paperless role allows.

If Dynamic discovery is not offered in your environment, email support@buildpaperless.com.au and we will help you set it up another way.

Microsoft Copilot changes its menus from time to time. If a step looks different, look for the option to add a connector, app or MCP server and use the same server URL.

Try asking

Which projects are behind schedule this week?
Brief me on Harbour Road before the client meeting
List the open defects on Smith Street
Add this caller as a lead (Starter plan)

Common questions

What does it cost?

Looking things up is free, up to 1,000 requests a month, for any organisation with an active subscription and a card on file. To let your assistant make updates as well, choose Starter ($49 + GST a month, 10,000 requests) or Growth ($149 + GST a month, 100,000 requests) in Settings, Integrations, AI and API access. A typical question uses 10 to 30 requests. Your AI assistant is billed separately by its own provider.

What can the assistant see?

Only what you approve when you sign in, and never more than your own Paperless login can see. If your role cannot see financials, neither can your assistant. On the free plan it is read-only and does not see dollar figures.

Can it spend money?

No. Anything involving money, like a purchase order, is only proposed. Someone on your team approves it in Paperless before it happens.

How do I disconnect it?

Remove the Build Paperless connector in your assistant. If you used an API key, revoke it on the page where you created it (Settings, Integrations, AI and API access, then Create an API key), which cuts access off straight away. To cut off a signed-in connection immediately, email support@buildpaperless.com.au and we will revoke it.

It says it cannot connect. What now?

Check you pasted the server URL exactly as https://www.buildpaperless.com.au/mcp, with nothing after it, and that you signed in with the Paperless login for the right organisation. If it still fails, email support@buildpaperless.com.au with a screenshot and we will sort it out.

Need a hand?

Email support@buildpaperless.com.au or call 1300 965 869 and we will walk you through it. Developers can find the full API in the developer docs.