What you can do
How Softr is organized
Almost every tool asks for a workspace, so it helps to know how the pieces fit together. A workspace is the top-level container, and everything else belongs to one:list_workspaces returns the workspaces you can reach, with their IDs. It is how the assistant turns “my Sales workspace” into the ID that every other tool needs, so it is often the first call in a conversation.
MCP server URL
Authentication
Softr’s MCP server supports two authentication methods. Both offer fine-grained control over what the AI tool can access.OAuth (recommended)
OAuth is the simplest way to connect. Softr has pre-built OAuth integrations for the following AI tools:
When you connect via OAuth, you are taken to a Softr authorization screen where you choose which permissions to grant. Only the permissions you approve are available to the AI tool, and you can revoke access at any time.
1
Open your AI tool's MCP settings
In Claude, Cursor, ChatGPT, or Mistral AI, navigate to the section where you add MCP servers or external connectors.
2
Add the Softr MCP server URL
Enter
https://mcp.softr.io/mcp as the server URL.3
Enter the Client ID
When prompted for a Client ID, paste the value from the table above that corresponds to your AI tool. If asked for a Client Secret, leave it blank — Softr’s OAuth clients are public and do not require one.
4
Authenticate with Softr
Click Connect or Authorize. You will be redirected to Softr to log in and approve the requested permissions.
5
Choose your permissions
On the Softr authorization screen, pick what the tool can access and how much it can do. See Permissions below.
The AI tool cannot ask for specific permissions in advance. You always choose them yourself on Softr’s authorization screen.
Personal access token
Use a personal access token if you are connecting a custom AI tool, building your own MCP client, or using any tool not listed above.1
Create a token
Go to Settings → API tokens and click Create. Give the token a name and an expiry (never, 1 year, 90 days, or 30 days).
2
Choose what it can access
On the Define scopes step, pick the workspaces the token covers and the permissions it carries. See Permissions below.
3
Configure your AI tool
Add the MCP server with Bearer token authentication:
Permissions
Whether you connect with OAuth or a personal access token, you choose permissions the same way: pick which workspaces are covered, then set an access level for each of three areas.
What each level allows:
Levels are bundles, not a checklist. There is no way to grant editing without reading, or database schema changes without record access. Picking a level always includes everything below it.
Managing access
Go to Settings → API tokens to see and remove access at any time.- Personal access tokens can be edited, regenerated, or deleted.
- Authorized apps lists the AI tools you connected with OAuth, with a Revoke button for each. Revoking one immediately invalidates the tokens it was issued.
The Authorized apps section only appears once you have authorized at least one app, so it will be missing if you have only ever used personal access tokens.
Example prompts
Once connected, you can work with your workspace in plain language:- “List all databases in my workspace.”
- “Search the Orders table for everything still pending and sort by date.”
- “Add a Priority field to Tasks with options Low, Medium, and High.”
- “Build me a chart block on the dashboard page showing revenue by month.”
- “What user groups can edit the Clients page?”
- “Create a workflow that sends me a Slack message whenever a new order comes in.”
- “Show me what the app looks like right now.”