Pangur docsConnect Claude, ChatGPT or a coding agent
You add Pangur to an assistant once, as a connector or a remote MCP server, and sign in with your Pangur account. This page gives the steps for Claude, ChatGPT and coding agents, and explains how to choose the project the assistant works in.
Connecting an assistant gives it Pangur's tools for your library. You add Pangur once, in the assistant's own settings, using Pangur's connector URL. The assistant then asks you to sign in to Pangur, and from that point on it can call Pangur's tools in any conversation. What a connected assistant can and cannot do is explained in Assistants and Pangur.
Before you connect
You need a Pangur account with at least one project, an assistant plan that allows custom connectors, and the web or desktop version of the assistant. Connecting works on every Pangur plan, Free included.
A new account's first project is called "My library". The connector setup in Settings appears only once the account has a project, so if it is missing, create a project on the Projects page first. As for the plan, Pangur's settings note that adding a connector requires an eligible paid plan on each product; which plans qualify is decided by Anthropic and OpenAI rather than by Pangur. Finally, you add the connector on claude.ai, in the Claude desktop app or on chatgpt.com, because the phone apps do not offer the setting. Once it is added, the connector works from your other devices too.
Finding the connector URL
Pangur's connector URL is shown in Settings. Open Settings, choose Assistants and command line, and under Add Pangur to Claude or ChatGPT find Connector URL (MCP server) and choose Copy.
On pangur.io the URL is https://pangur.io/mcp. Another Pangur deployment shows its own address here.
Connecting Claude
You can add Pangur on claude.ai or in the Claude desktop app.
- In Claude, open Settings, then Connectors.
- Choose Add custom connector, paste the connector URL and choose Add.
- Choose Connect. Claude opens Pangur's sign-in page.
- Sign in with the Pangur account whose library you want Claude to use.
On a Claude Team or Enterprise plan, an Owner of the Claude organisation first adds the connector under Organization settings → Connectors. Each person who then connects it signs in with their own Pangur account, and the assistant sees that account's library.
Connecting ChatGPT
ChatGPT adds Pangur as an app in developer mode.
- On chatgpt.com, open Settings, then Apps, then Advanced settings, and turn on Developer mode.
- In Apps, choose Create app and paste the connector URL.
- Choose OAuth as the authentication method, create the app, and authorise Pangur by signing in with your Pangur account.
Pangur's search and fetch tools follow the names and shapes that ChatGPT's deep research expects, so ChatGPT can use them in deep research as well as in an ordinary chat.
Connecting a coding agent
Coding agents such as Claude Code, Codex and Cursor connect to the same URL. Pangur's server speaks the MCP streamable HTTP transport and uses OAuth for sign-in, so you add Pangur as a remote (HTTP) MCP server in the agent's configuration, with the connector URL as its address. When the agent first connects, it opens a browser window for you to sign in to Pangur, and the browser hands the sign-in back to the agent running on your computer.
In Claude Code, for example, the command is:
claude mcp add --transport http pangur https://pangur.io/mcpThen use Claude Code's /mcp command to authenticate. For Codex, Cursor and other agents, follow that agent's own instructions for adding a remote MCP server with OAuth, because Pangur's settings give no agent-specific steps.
If you want to work with Pangur from a terminal without an assistant in between, the command line does the same work directly and can also edit and delete.
Manual connector setup
Normally you only paste the URL, and the assistant registers itself with Pangur's sign-in service automatically. Some organisations block that automatic registration, in which case you enter Pangur's public client ID by hand.
- In Pangur's Assistants and command line settings, open Manual setup, if it doesn't connect on its own and copy the OAuth Client ID. On pangur.io it is
zcp-mcp. - In Claude, open the connector's Advanced settings; in ChatGPT, use the app's OAuth fields. Enter the client ID there.
- Leave the client secret blank. The client is public and has no secret.
Choosing the project the assistant works in
The assistant works in your default project, which is the project you opened last in Pangur on any device. To change it, open the project you want in Pangur before you start, and the assistant's next tool call uses it.
You can also ask the assistant to work in a named project. It calls list_projects to see your projects with their ids and addresses, and passes the one you named to each tool call. If the name matches no project, Pangur tells the assistant so and reminds it that list_projects shows the ids and slugs.
To keep an assistant to one part of a project, the project's owner can scope the project to a collection in its settings with Scope to collection:. The rules are under Scope to one collection.
A first question
Pangur's settings suggest a first question of this kind:
What does my library say about the Edict of Nantes? Quote the passages and cite them.
The assistant calls ask_library, which returns ranked passages from your sources with their locators, and writes an answer citing them. To keep the answer, ask the assistant to save it as a document (it uses create_document and gives you a link) or to add it to an Ask conversation (it uses record_ask_turn, and the answer then appears in Ask labelled as the assistant's).
If Ask in Pangur says that your library is being read, Pangur has not yet finished reading your files into its index, and passages from the files it has not read cannot be returned yet (see How Pangur reads your sources for what is read and how long it takes).
When a connection fails
These are the messages and situations you are most likely to meet.
| What you see | What it means and what to do |
|---|---|
| "Your account is on the waitlist and not yet approved." | The Pangur account you signed in with has not been admitted yet. Tools work once it is. |
| "This account has no project yet. Create one at pangur.io or in the Pangur app, then try again." | Create a project in Pangur, then ask again. |
| "That item is outside this connection's collection scope." | The project is scoped to one collection and the item is not in it. Change the scope in project settings, or work in another project. |
| "Editing and deleting are not available to assistants." | Assistants can only add. Make the change in the web app or with the pangur command. |
| "Pangur does not call a model on behalf of an MCP session…" | The assistant asked Pangur to run a model. It should ask for the materials and do the work itself. |
| The assistant reports that its session ended or was not found | A session closes after 30 minutes without use, and also when an update to Pangur changes its list of tools. Most clients reconnect on their own; if yours does not, start a new conversation or reconnect the connector. |
Disconnecting an assistant
To stop an assistant using Pangur, remove or disconnect the Pangur connector in the assistant's own settings. Pangur has no page that lists the assistants you have connected.
Assistants and Pangur
An assistant such as Claude or ChatGPT can be connected to your Pangur library. This page explains what a connected assistant can and cannot do, which project it works in, and who pays for the model it uses.
The command line
The pangur command works with your library from a terminal. This page covers installing it, signing in from a laptop or a remote machine, and the commands you will use first.