Use Proma from Claude, ChatGPT and other AI apps

The Proma connector lets an AI app, such as Claude or ChatGPT, work in your Proma organization for you. You ask in plain words. The app can explain how your systems are set up, answer questions about your data, add and update records, build new systems or add to existing ones, and design forms. It signs in as you, so it can only do what your own Proma account is allowed to do.

The connector uses MCP (Model Context Protocol), a standard many AI apps use to connect to other services. In your app’s settings it may be called a connector, an app, a plugin or an MCP server.

Connector address: https://server.proma.ai/mcp/connectors

What you need

A Proma account in at least one organization. If you don’t have one, sign up at app.proma.ai first. The sign-in page you see while connecting never creates an account.
[Proma plan: say which Proma plans can use the connector, or delete this line]
An AI app that can add connectors:
- Claude: Free, Pro, Max, Team and Enterprise plans, on the web and in Claude Desktop. On the Free plan you can add one custom connector. On Team and Enterprise plans, an Owner may need to add or turn on Proma first.
- ChatGPT: [ChatGPT plans: list the plans that can add custom MCP servers]. You add Proma in ChatGPT on the web. If you use ChatGPT through a work or school workspace, an admin may need to allow custom MCP servers before you can add Proma.
- Claude Code, Codex, Cursor and other tools: any version that can connect to a remote MCP server with sign-in (OAuth) and automatic client registration.

Connect Proma

Every app ends at the same Proma sign-in page. “The Proma sign-in page” below shows what you’ll see there.

Claude (web and desktop)

From Claude’s directory [ONLY AFTER CLAUDE LISTING]

In Claude, open Customize → Connectors and click + next to Connectors. You can also get there from a chat: click + at the lower left, then Connectors, then Manage connectors.
Find Proma and click Connect.
Sign in on the Proma page and click Allow.

On Team and Enterprise plans, an Owner turns on Proma for the whole organization first. Then each person connects with their own Proma account.

By address

Open Customize → Connectors (claude.ai/customize/connectors).
Click + Add, then Add custom connector.
Enter Proma as the name and click Continue.
Paste https://server.proma.ai/mcp/connectors and click Continue.
Under Authentication, choose Sign in now.
Under OAuth client, choose Register automatically.
Leave Request headers empty and click Add.
Sign in on the Proma page and click Allow.

On Team and Enterprise plans, an Owner adds the connector instead. They go to Organization settings → Connectors, click Add, point to Custom and choose Web, then follow the same steps. After that, each person opens Customize → Connectors, finds Proma and clicks Connect.

Use it in a chat: click + at the lower left, choose Connectors and switch Proma on.

ChatGPT

From the ChatGPT directory [ONLY AFTER OPENAI LISTING]

Open chatgpt.com/plugins.
Find Proma and add it.
When asked, sign in on the Proma page and click Allow.
In a new chat, type @ and choose Proma.

By address (ChatGPT on the web)

Open chatgpt.com/plugins.
Click the + button, then Add custom MCP server.
Enter Proma as the name. Under Connection, paste https://server.proma.ai/mcp/connectors as the Server URL.
For authentication, choose OAuth. Leave any client ID and secret empty, because ChatGPT sets itself up with Proma.
ChatGPT shows a warning about the risks of adding a custom server. This is expected. Read it, then select I understand and want to continue.
Select Create as a plugin.
Find Proma under your personal plugins and install it with the + button. When asked, sign in on the Proma page and click Allow. This happens while you install it or the first time you use it.
In a new chat, type @ and choose Proma.

Claude Code

Install the Proma plugin (recommended). It adds the connector, plus guidance that helps Claude use Proma well.

In Claude Code, run /plugin marketplace add growthzilla/proma-agent-plugin.
Run /plugin install proma@proma. Choose who gets it: just you, everyone working in this repository, or just you in this repository.
If Claude Code asks you to, run /reload-plugins.
Run /mcp, choose the Proma entry (it may be listed as plugin:proma:proma) and sign in. The Proma page opens in your browser.

Or add it by address

In your terminal, run claude mcp add --transport http proma https://server.proma.ai/mcp/connectors.
Start Claude Code, run /mcp, choose proma and sign in. The Proma page opens in your browser.

Codex (terminal, IDE extension and desktop app)

From the directory [ONLY AFTER OPENAI LISTING]

Once Proma is in OpenAI’s directory, you can also add it in Codex. [Codex directory steps: write the steps once Proma shows up in Codex]

By address, in the terminal

Run codex mcp add proma --url https://server.proma.ai/mcp/connectors.
Run codex mcp login proma. The Proma page opens in your browser.
To check that Proma was added, run codex mcp list.

By address, in the IDE extension or desktop app

Open settings (in the IDE extension, use the gear menu) and choose MCP servers, then Add server.
Enter Proma as the name, choose Streamable HTTP and paste the connector address.
Save, then click Restart (in the IDE extension, Restart extension).
Click Authenticate and sign in on the Proma page.

The terminal, the IDE extension and the desktop app share these settings, so you only need to add Proma once.

Cursor

Open ~/.cursor/mcp.json to use Proma in all your projects, or .cursor/mcp.json inside one project. Create the file if it doesn’t exist.
Add Proma: { "mcpServers": { "proma": { "url": "https://server.proma.ai/mcp/connectors" } } }. If the file already lists other servers, add the "proma" entry next to them.
Don’t add any sign-in details. Cursor sets itself up with Proma.
When Cursor asks you to sign in to Proma, follow its prompt and sign in on the Proma page.

Other AI apps

Apps that connect to a remote MCP server with OAuth sign-in and register themselves automatically (dynamic client registration) can use Proma.

Add https://server.proma.ai/mcp/connectors as a remote server. Your app may call this type “HTTP” or “Streamable HTTP”.
Choose OAuth sign-in and leave any client ID and secret empty. Proma has no client IDs to hand out, so an app that needs one can’t connect yet.

Whichever app you use, Proma opens its own sign-in page in your browser. The browser tab says “Connect to Proma”, and the address starts with https://server.proma.ai/.

Step 1: Sign in. The page says Connect Claude to Proma, with your app’s name in place of Claude. Enter your Email, then choose one:

Email me a code. If that email has a Proma account, we send it a 6-digit code. Enter it under Code and click Continue.
Use my password. Enter your Password and click Continue.

You can switch between them with Use my password instead or Email me a code instead. Cancel stops at any point.

Step 2: Allow. The page asks Allow Claude to use Proma?, again with your app’s name, and shows:

Organization. If you belong to one organization, its name is shown. If you belong to several, choose one from the Organization list. The app works only in the organization you choose.
“It will be able to:” One or both of these lines:
- “See your spaces, systems, data, forms and automations”
- “Create and change systems, rows, forms and automations”
“It acts with your own Proma permissions, within this organization only.”

Click Allow to connect, or Cancel to stop without connecting. After you click Allow, you go back to your app.

Notices about the app. Some apps get a notice near the top of the page:

Claude, ChatGPT and Grok get no notice. Proma recognises them by the website it sends you back to after you click Allow (claude.ai, claude.com, chatgpt.com or grok.com), and shows their name itself.
Apps on your own computer, such as Claude Code, Codex or Cursor, get this notice: “An app on this computer (…) is asking to connect. Continue only if you just started it.” In place of the dots, the notice shows how the app receives the sign-in, such as localhost or cursor:.
Any other app gets a red notice: “Unrecognised app. After you allow it, you will be sent to …. Continue only if you trust that site.” In place of the dots, the notice names the website the app will send you to. These apps choose their own name, so the name alone doesn’t prove who they are.

What the AI app can do

The app works as you, in the one organization you chose, and only with what your Proma account can reach there.

Look (Read only or Read + Write)

Explain how your workspace is set up: spaces, systems, datasets, columns, forms and interfaces.
Look up records, up to 100 at a time.
Answer questions about your data, such as “How many orders came in this week, by region?”. One answer can include up to 1,000 rows.
See your automations, their recent runs and why a run failed, plus the names of the accounts your automations use.

A data question can read every row of any dataset you have access to, including rows that an interface’s filters or your role’s setup would normally hide from you in Proma.

Change (needs Read + Write, and admin access in Proma to the system being changed)

Add or update records, up to 50 at a time.
Build a new system, or add datasets, columns, interfaces and forms to an existing one, from a plain-language description.
Design forms and change how they look.

Delete (needs Read + Write, and admin access to that system in Proma)

Delete columns, interfaces or datasets. A delete request only shows a preview of what would be removed, unless the app marks it as confirmed. Apps usually get the preview first, but Proma doesn’t require it, and your app may not show the preview to you. Ask the app what will be removed before you agree.
Deleting a column erases every value in it, and deleting a dataset deletes all of its records. The app can’t undo either. [Recovery: say whether support can restore a deleted column or dataset and how soon to ask, or write “It can’t be undone.”]

Automations

[PENDING — use version A if every AI app can still build automations, version B if ChatGPT can only look at automations. Keep one version, then delete the other version and every bracketed label.]

[Version A]

With Read + Write access, the app can also build and publish automations, turn them on or off, and delete them.
A published automation goes live straight away. Ask the app to show you the automation before it publishes it. Scheduled automations start switched off until you or the app turns them on.
Deleting an automation happens at once, with no preview step.

[Version B]

In Claude and other apps, with Read + Write access, the app can also build and publish automations, turn them on or off, and delete them.
A published automation goes live straight away. Ask the app to show you the automation before it publishes it. Scheduled automations start switched off until you or the app turns them on.
Deleting an automation happens at once, with no preview step.
In ChatGPT, Proma can only look at automations. To build or change one, use Proma itself or another connected app.

[End of PENDING]

Your app may ask before it changes anything. Proma labels every action that changes or deletes something, so your AI app can ask you first. Whether it does depends on the app and your settings there. In Claude, for example, you can choose to always allow an action, and Claude then stops asking. If you’ve chosen to always allow Proma’s actions, the app won’t stop to ask. Read what the app plans to do before you confirm.

Access: Read only or Read + Write

Read + Write: the app can look, change and delete, as listed above.
Read only: the app can look. Anything that would change something is refused.

You don’t choose the access on the Proma page. The app asks for what it wants, and the Allow page lists it under “It will be able to:”. Most apps ask for Read + Write. If an app doesn’t ask for anything specific, Proma gives it Read + Write. If you don’t want to give the access shown, click Cancel.

Either way, the app never gets more than your own Proma role allows. To read a system, you need access to it. To change its records or how it’s set up, you need admin access to that system. Organization owners and admins have admin access to every system.

Connected apps shows which access each app has.

See and disconnect your apps

Sign in to Proma and open app.proma.ai/profile/connected-apps. This is the Connected apps page in your profile settings.
Each app shows its name, the address Proma sends you back to after sign-in, its access (Read only or Read + Write) and the date you connected it. Some apps have a badge: On this computer for an app on your own computer, or a red Unverified for an app Proma couldn’t recognise.
Click Disconnect next to an app, then click Disconnect again to confirm. If you have two or more apps, Disconnect all removes all of them at once.

The app loses access right away, though in rare cases it can take up to about a minute. To use it again, connect it from the app and click Allow again.

Good to know:

The page lists the apps you connected in the organization you’re working in now. To see apps you connected in another organization, switch to it in Proma.
You see and manage only your own connections.
Removing Proma inside the AI app stops that app from using it. The app may still be listed in Connected apps until you disconnect it there or the connection expires.

Connections expire after 30 days unused

A connection stays active while the app keeps using Proma. If it goes 30 days without using Proma, the connection ends. To keep using Proma, connect again from the app.

Limits

These limits keep Proma fast and safe for everyone. They’re approximate.

About 120 actions a minute for each person in an organization, shared by all the apps they connected there. Looking things up counts too. Past that, Proma tells the app to wait about a minute.
Records: up to 100 read at a time, up to 1,000 in one answer, and up to 50 written at a time. For large exports, use Proma itself.
Sign-in: the sign-in page stays open for 10 minutes. Sign-in attempts, code emails and new app registrations are also limited. See Troubleshooting for the messages you might see.

Stay safe

Approve only apps you recognise. Check the app name and any notice on the Proma page. Proma names Claude, ChatGPT and Grok itself. Other apps choose their own name, so read the notice. If it says “Unrecognised app”, look at the site it will send you to.
Don’t approve a sign-in you didn’t start. If a link from someone else opens a Proma sign-in page, click Cancel. Only enter your Proma password on a page whose address starts with https://server.proma.ai/ or https://app.proma.ai/.
Read before you confirm. When the app wants to change or delete something, check what it plans to do, and ask what will be removed. Remember that deleting a column or a dataset also deletes the data in it.
Watch for tricks hidden in content. Text the app reads can contain instructions meant to fool it. That text could be in a web page, an email, a document, or even a record someone else typed into Proma. The app might then try something you didn’t ask for, such as deleting data or sending it somewhere else. If the app suggests an action you didn’t ask for, say no.
Check automations before the app publishes them. A published automation goes live straight away. It runs on its own and can send data to other services through your organization’s connected accounts. Ask the app to describe the automation and wait for your OK before it publishes.
Disconnect apps you no longer use. Look at Connected apps now and then.

Troubleshooting

“Too many attempts. Try again in a minute.” Many sign-in steps came from your network in a short time, for example in a busy office, or the buttons were clicked very quickly. Wait a minute and try again.
“Too many attempts. Try again in 15 minutes.” Too many codes or passwords were tried for this email from your network. Proma allows 10 code tries and 10 password tries in 15 minutes. Wait 15 minutes, or use the other sign-in option.
“Too many codes requested. Try again in 15 minutes, or use your password.” Proma sends up to 5 code emails in 15 minutes for one email from one network, and codes for Proma’s own sign-in page count too. Wait 15 minutes, or click Use my password.
The code didn’t arrive. Check your spam folder. Codes are sent only to emails that have a Proma account. If you ask again within 2 minutes, no new email is sent. You can also click Use my password.
“That code didn’t work. Check it and try again.” Check the code in your newest email and enter it again.
“Wrong email or password.” Check both, or click Email me a code instead.
“This sign-in has expired” The sign-in page was open for more than 10 minutes. Go back to the app you were connecting and start again.
“Invalid request” The connection link was broken or out of date. Start connecting again from your app.
“No Proma organization” Your account isn’t part of any Proma organization yet. Ask an admin to invite you, or create an organization at app.proma.ai, then connect again.
The app is using the wrong organization, or can’t find a system. Each connection works in one organization. Disconnect the app in Connected apps, connect again from the app, and choose the other organization on the Allow page. If the system is in the right organization, check that your Proma role can see it.
The app says you have “read-only access” to a system. Your Proma role can view that system but not change it. Ask an organization admin for admin access to that system.
The app says the connection was granted “proma:read” only. The app asked only to look when you connected. Disconnect it in Connected apps, then remove Proma in the app, add it again and check the Allow page. If the page still lists only “See your spaces, systems, data, forms and automations”, that app only asks to look. To make changes, use Proma itself or another app from this page.
The app says Proma needs to be reconnected, or that signing in to Proma failed. The connection was disconnected, or it went 30 days without being used. Connect again:
- Claude: open Customize → Connectors, choose Proma and click Connect.
- Claude Code: run /mcp, choose the Proma entry and pick Re-authenticate.
- Codex: run codex mcp login proma.
- ChatGPT, Cursor and other apps: follow the app’s sign-in prompt, or remove Proma and add it again.
The app says its work is paused by Proma’s rate limit. Your apps in this organization made more than about 120 actions in a minute between them. Wait a minute, then let the app continue. It also helps to ask for the work in bigger batches.
“Too many client registrations from this address. Try again in a minute.” Too many apps registered with Proma from the same address at once. With Claude or ChatGPT this can happen when many people connect at the same moment. Wait a minute and try again.
The Proma page says “Unrecognised app”, or Connected apps shows “Unverified”. Proma couldn’t confirm which app this is, because it doesn’t send you back to Claude’s, ChatGPT’s or Grok’s own website. Continue only if you started the connection yourself and trust the site shown. If you see an app in Connected apps that you don’t recognise, click Disconnect.
The Proma page says “An app on this computer”. This is normal for Claude Code, Codex, Cursor and other tools that run on your computer. Continue only if you just started the connection.

Still stuck? Email [support@proma.ai].

Your data

Whatever the app reads from Proma goes to that app and its provider, for example Anthropic for Claude or OpenAI for ChatGPT. Their terms and privacy policy cover it from then on.
Proma keeps a record of each connection: the app’s name, the address Proma sends you back to, the organization, the access and the date. Connected apps shows these, except the organization, which is the one you’re working in. We delete the record as soon as you disconnect the app, or after 30 days without use. Sign-in tokens are stored only in scrambled (hashed) form, so they can’t be read back.
While you sign in, Proma holds your email for up to 10 minutes to finish the sign-in, then deletes it.
Proma also logs which actions the app runs, when, and for which account and organization, plus the text of data questions the app asks. The contents of your records aren’t logged, but a data question or an error message can include values from them, such as a name the app searched for.
Changes the app makes are recorded in the same way as changes you make in Proma yourself.

For full details, read our privacy policy.

Help and Contact

Support: email [support@proma.ai]. Tell us which AI app you use, what you asked it to do and roughly when. Never send us your password or a sign-in code.
Privacy questions: email privacy@proma.ai.
Privacy policy: proma.ai/privacy
Terms of service: proma.ai/tos