How to connect Projectworks to ChatGPT, Copilot or another AI tool (beta)
Add Projectworks as a custom connector to any AI tool that supports MCP, with specific steps for ChatGPT and Microsoft Copilot Studio.
Please note this is a Beta Feature.
Overview
Projectworks connects to AI tools through the Projectworks MCP (Model Context Protocol) server. Any AI tool that lets you add a custom MCP connector can connect to it, including ChatGPT and Microsoft Copilot Studio.
Each person signs in with their own Projectworks account, and the AI tool only ever sees and does what that login allows. Before anything changes in Projectworks, the tool shows what it will do and asks for confirmation.
Using Claude? It’s quicker to add Projectworks from Claude’s connector directory. See How to connect Projectworks to Claude →
Before you start
- MCP Access turned on for your Projectworks account. A Projectworks administrator goes to ⚙️ Settings > Beta Features, turns on “MCP Access (beta)”, then selects Save. This should already be on for your account; if it isn’t, an administrator can turn it on here.
See Enabling Beta features → - An access level that allows MCP. Go to ⚙️ Settings > Access Levels > More Options, scroll to the MCP settings, and check MCP (all) and MCP.Access are ticked for your access level.
See How to set up access levels and permissions in Projectworks → - An AI tool that supports custom MCP connectors. Your plan, or your organisation’s admin, may need to allow custom connectors first.
How to connect any AI tool
These steps work for any AI tool that supports custom MCP connectors. The exact menu names differ between tools; see below for ChatGPT and Copilot.
- In your AI tool, find where to add a custom connector, MCP server or tool.
- Enter these details:
Name Projectworks Server URL https://projectworksapp.com/mcpAuthentication OAuth 2.0 Client ID and secret Leave blank. Your AI tool registers itself with Projectworks automatically. - When the Projectworks login page opens, sign in the way you normally do.
- On the authorisation page, check the site name is correct, then select Allow.
- Check the list of Projectworks tools appears in your AI tool, then start a new chat and ask, “What can you do in Projectworks?”
“Unverified application” is expected. Because your AI tool registers itself automatically, the Projectworks sign-in screen labels it an unverified application
ChatGPT
In ChatGPT, you add Projectworks as a plugin using a custom MCP server. You can add custom MCP servers on any ChatGPT plan, including Free. On a Business or Enterprise workspace, your admin may need to allow it first.
Use ChatGPT in a web browser to connect. The steps are different in the ChatGPT desktop and mobile apps. Once Projectworks is connected, you can use it in the apps too.
Step 1: Add a custom MCP server
- In a web browser, go to chatgpt.com, sign in, and select Plugins in the sidebar.
- Select Add at the top right, then Add custom MCP server.
Step 2: Enter the Projectworks details
- Enter Projectworks as the Name. Icon and Description are optional.
- Under Connection, keep Server URL selected and enter
https://projectworksapp.com/mcp. - Set Authentication to OAuth. Leave Advanced OAuth settings as they are.
- Read the warning, tick I understand and want to continue, then select Create as a plugin.
Step 3: Sign in to Projectworks and allow access
- In Connect Projectworks, select Connect Projectworks.
- The Projectworks login page opens. Sign in the way you normally do. If you’re already signed in, this page is skipped.
- On Authorize ChatGPT, check the site name shown in bold is correct, then select Allow.
Step 4: Try it out
- You’re returned to the Projectworks plugin page in ChatGPT. Select Try in chat.
- Ask, “What can you do in Projectworks?”
Microsoft Copilot (Copilot Studio)
In Copilot, you build an agent in Copilot Studio first, then add Projectworks to it as a tool. People then use the agent in a channel such as Microsoft Teams. You need access to Copilot Studio at copilotstudio.microsoft.com; if you don’t have it, ask your Microsoft 365 administrator.
On the Projectworks sign-in screen, Copilot Studio appears as Credential Manager. This is expected.
Step 1: Create the agent
- In Copilot Studio, check the environment shown at the bottom left of the sidebar. Build the agent in the environment your organisation uses for production agents.
- On Home, select Agent.
- Name the agent Projectworks and choose a model under Model.
- Optional: under Instructions, describe how the agent should behave, such as the tone to use or the kinds of questions it should answer.
Step 2: Add Projectworks as an MCP tool
- In the right-hand panel, select + next to Tools.
- In Add a tool, open the MCP tab, select + Add, then choose Model Context Protocol (MCP).
- Enter these details, then select Add:
Server name Projectworks MCP Server description Connects to your Projectworks data Server URL https://projectworksapp.com/mcpAuthentication OAuth 2.0 Configuration type Dynamic (with discovery)
Step 3: Create the connection and sign in
- In Select a connection, open the Connection dropdown and select Create new connection, then Create.
- Sign in to Projectworks when the window opens.
- On Authorize Credential Manager, check the site name is correct, then select Allow.
- Back in Select a connection, the connection shows a green tick. Select Add.
Step 4: Set authentication to End user account
- In Edit tool, open the Authentication dropdown and choose End user account.
- Check the list of Projectworks tools loads, then select Done.
Don’t choose Shared account. With a shared account, everyone using the agent acts as the person who created the connection, with that person’s permissions. End user account makes each person sign in as themselves.
Step 5: Publish the agent
- Select Publish at the top right. When the agent is published, select Add channels.
- Choose a channel. Teams and Microsoft 365 Copilot is the best place to start for most teams.
- Check who can see the agent. Making it available to your whole organisation may need approval from your Microsoft 365 or Teams administrator, so start with a small pilot group if you can.
The first time each person uses the agent, they’re asked to sign in to Projectworks with their own account.
Security and good practice
- Your AI tool works within each person’s Projectworks permissions. It can’t see or change anything their login can’t.
- Give people the least-privileged Projectworks access level that suits their work.
- Start with questions before asking the AI tool to make changes, and read each plan before you confirm it.
- Never share Projectworks passwords or connection details in a chat.
- You can disconnect at any time from Connected Apps in your Projectworks account settings.
For more, see Security and data for Kea and the Projectworks MCP →.
To see everything you can ask for, see What can Kea and the Projectworks MCP do? →
Troubleshooting
The AI tool can’t find any Projectworks tools
Check that MCP Access is turned on for your account and that your access level has MCP (all) and MCP.Access ticked (see Before you start).
Still stuck? Contact Projectworks support with a screenshot of the error