Before you start
ERPoida account
With a verified email address and access to a workspace.
Assistant plan
A Claude or ChatGPT plan that supports custom remote MCP connectors.
Admin allows it
Your assistant administrator permits custom connectors.
Set up in 3 steps
Add the connector
In Claude: Settings → Connectors → Add custom connector. In ChatGPT: the custom MCP connection controls available to your account. Paste the server URL and choose OAuth.
Sign in and pick a workspace
Sign in to ERPoida in the window that opens, choose the workspace the assistant should use, and approve.
Turn it on in a chat
Enable the connector in a conversation and try one of the prompts below.
Passwords and access tokens stay in the sign-in flow. You never paste them into a conversation.
Step by step in Claude and ChatGPT
Claude
Pro, Max, Team and Enterprise plans.
- Pro or Max: open Settings → Connectors and select Add custom connector.
- Team or Enterprise: an Owner adds the connector once under Organization settings → Connectors. Members then connect it from Settings → Connectors.
- Name it ERPoida, paste the server URL and select Add.
- Select Connect, sign in to ERPoida and approve one workspace.
- In a chat, open the + menu → Connectors and switch ERPoida on.
Works the same in claude.ai, Claude Desktop and the mobile apps once it is added on the web.
ChatGPT
Plans that offer developer mode for MCP apps, such as Plus, Pro, Business and Enterprise.
- Business or Enterprise: a workspace admin first allows custom MCP connectors under Workspace settings → Permissions & roles.
- Open Settings → Apps → Advanced settings and turn on developer mode.
- Select Create app, name it ERPoida, paste the server URL and choose OAuth as authentication.
- Sign in to ERPoida in the window that opens and approve one workspace.
- In a chat, pick ERPoida from the tools menu and ask your question.
Menu names change from time to time. If a step looks different, search the ChatGPT help center for “developer mode”.
What the connector can do
ERPoida offers its tools to the assistant under your own role. Every tool is marked as read-only or as one that changes data, so Claude and ChatGPT can ask you before a change.
| What the connector can do | Reads | Changes |
|---|---|---|
| Records and CRM | Lists, searches and opens records, comments, history and attachments; totals and groups. | Creates and updates records and comments; deletes a record when your role allows it. |
| Projects and time | Tasks, timesheets and running timers. | Creates tasks and time entries; starts, pauses and stops timers. |
| Drive and documents | Folders, documents and their contents; downloads files. | Creates, edits and moves documents and folders; uploads files. |
| Sales and finance | Invoices, payment terms, accounts and the trial balance. | Creates and posts invoices and journal entries, records payments. Posted entries are locked and corrected by reversal, as in the app. |
| Operations | Products, stock on hand, warehouses, purchase and production orders. | Creates and confirms purchase orders, receipts and deliveries; runs production orders. |
| Email, flows and setup | Linked email threads, flows and their runs, views, dashboards and charts. | Replies to email, runs or approves flows, creates views, dashboards, custom fields and share links. |
Which tools appear depends on the modules enabled in your workspace and on your role.
Try these prompts
Replace the example names with projects, companies or documents in your workspace.
- Projects
“Show the tasks that are To Do or In Progress in my current workspace, grouped by priority.”
- CRM
“Find my CRM companies matching Acme and show their contacts.”
- Projects
“Find the project called Connector Review and create a task called Prepare launch notes. Show me the task you created.”
- Drive
“Create a Drive document called Weekly update with a Markdown heading and a checklist of the next steps.”
- Drive
“Find the Drive document called Connector Review Notes and summarize its contents.”
The assistant can read and change data when your role permits it. Review the details before confirming a deletion, overwriting a document, a financial action or running an automation.
Your data and access
What the assistant sees
Only the records and document contents needed for the tools it calls, in the one workspace you approved. Connect again to authorize a different workspace.
What gets logged
Every tool call, its arguments and its outcome land in the ERPoida action log. Inline file contents are excluded. The assistant provider also processes inputs and results under its own policies.
How to revoke
Open Settings → Access tokens in ERPoida and revoke the connection’s token, or remove the connector in Claude or ChatGPT.
Data handling
- What is sent
- Only what a tool returns for your request: the records, fields, document contents and comments you can see in ERPoida. Fields hidden from your role are never returned.
- Where it runs
- The ERPoida application and database are hosted in the European Union. Claude or ChatGPT then process the results under your own account with that provider.
- How long we keep it
- Each tool call is recorded in your workspace action log for 30 days. Entries for changes to financial records are kept for 8 years, as German tax law requires.
- Sign-in and tokens
- You sign in with OAuth. The token is bound to one workspace, stays valid until you revoke it, and is never shown to the assistant or pasted into a chat.
Good to know
- One connection reaches one workspace. Connect again to use another.
- The assistant can never do more than you can in ERPoida: roles, locked records and finance rules still apply.
- Files up to 10 MB can be uploaded or downloaded through the connector. Use the app for larger files.
- Requests are rate-limited per account. If you hit the limit, wait a minute and try again.
Troubleshooting
Sign-in does not open
Check that you entered the full server URL, and that your assistant administrator permits custom connectors.
Access is denied
Verify your email address, reconnect if a token was revoked, or ask your workspace administrator to check your role.
A tool or record is missing
Check that its module is enabled and that you authorized the intended workspace.
A write fails
Use the field named in the error to correct the request. Locked records and finance rules still apply.
Still stuck?
Email [email protected] with the assistant you use, the time of the problem and the error message.

