Projul AI Connect works with any tool that lets you add an MCP server by web address and a request header, such as Cursor, Windsurf, VS Code with Copilot, or Gemini CLI. You give the tool the address https://connect.projul.com/mcp and one header, Authorization set to Bearer followed by your API key.
You need an API key first. See How do I get my Projul AI Connect API key? A Read key lets your AI look at your data; a Read-Write key also lets it create and change records. See Should I give my AI a Read key or a Read-Write key?
Add the server
Most tools keep MCP servers in a JSON settings file.
- Open your tool's MCP settings, such as "MCP" in Cursor or "MCP servers" in Windsurf, or the mcp.json file it points you to.
- Add a server named "projul" with the address and header below.
{
"mcpServers": {
"projul": {
"url": "https://connect.projul.com/mcp",
"headers": {
"Authorization": "Bearer prjl_live_YOURKEYHERE"
}
}
}
}
VS Code uses "servers" in place of "mcpServers" and adds "type": "http". Gemini CLI uses "httpUrl" in place of "url". The address and the header are the same in every tool.
Note: Windsurf allows 100 MCP tools in total across every connected server, and Projul publishes more than 75 of them. If you have other MCP servers connected, open the Projul server's settings from the "MCPs" icon at the top right of the Cascade panel and turn off the tools you do not need.
Check that it works
Ask the tool a question only Projul can answer.
What clients do I have in Projul? Just list their names.
If it lists your clients, you are connected. If it reports it could not connect, check the header for a typo, an extra space, or a missing "Bearer" before the key. The "API keys" section under "Settings" and "Projul AI Connect" shows when the key was last used.
For more ways to confirm the connection, see How do I check that my AI is connected to Projul?
Note: Your key is stored in the tool's settings file on your computer. Do not share that file or commit it to a shared code repository.
Note: Projul AI Connect currently offers API keys only. A tool that requires a sign-in flow and has no way to add a header cannot connect yet.
Questions? Let's Chat.
support@projul.com
(844) 776-5853