Feature area
AI agents working within the perimeter
AI assistants want to act on your processes: read cases, start new ones, update data. FlowSharp allows it with an MCP server of 34 tools, but within a perimeter. Every key has a whitelist of tools and flows, every action is attributed to a client and a person, and cases created by agents are born awaiting confirmation. The agent works, accountability stays clear.
AI agents and MCP
- 1MCP server with 34 tools
- 2Agent attribution
- 3Built-in Flow Agent
- 4OAuth connection for ChatGPT and claude.ai
6 features
Three problems this area solves
Access too broad
A generic key gives the agent more power than needed, and nobody knows what it can do.
Actions without an owner
When an agent acts, only the client name appears in the history, not the person.
Costs out of control
An agent starting cases in a loop burns credits and produces useless work.
MCP server with 34 tools
34 tools with minimum role and annotations, for MCP-compatible clients.
The server exposes 34 tools to MCP-compatible clients, each with the minimum role required and a read-only or destructive annotation.
Technical details
- Flows: list, read, export, create, generate with AI, publish.
- Cases: list, read, history, create, transition, update data.
- Tasks; documents (ingest from URL, signed link, text, library).
- Events, dashboard and analysis; Process Map (health, export, import); Solutions (export, import).
- Streamable HTTP transport.
- Schemas enforced before any change.
- Safe retries (expected state, idempotency keys, data revision).
Agent attribution
History shows the AI client and the person holding the key; the cost goes to the key.
Behind every agent action there is an accountable person. The AI cost of a case started by an agent is attributed to the key.
Built-in Flow Agent
A conversational assistant always at hand (⌘/Ctrl+J), always within the user's permissions.
It explains flows, searches and reads cases, fills in initial data and proposes starts. It is also available as an MCP tool.
Technical details
- Data Shield always applied.
- Knows documents marked "agent context".
- Can be switched off per organization.
The features
OAuth connection for ChatGPT and claude.ai
Profile created by the Admin, automatic client registration and consent showing role, tools and flows.
Show detailsHide details
The Admin creates a profile with maximum role, tools and flows. The client registers itself. The user approves a consent screen showing exactly what is granted.
Technical details
- PKCE mandatory.
- Effective access is the minimum between profile and current permissions.
- Immediate revocation.
Scoped MCP keys
Whitelist of tools and flows, expiry preset at 90 days, never in the query string.
Show detailsHide details
Folder permissions apply to the agent too: flows it cannot read "do not exist" for it.
Guided import of maps and solutions by agents
Preview by default; applying requires a request identifier.
Show detailsHide details
An agent proposes an import, but applying it requires a request identifier and explicit consent to the policies.
Technical details
- At most 20 applications per hour per key.
- Idempotent replay.
Deep dive
Complete tools, narrow perimeter
The MCP server exposes 34 tools with the minimum required role and a read-only or destructive annotation: flows, cases, tasks, documents, events, dashboard and analysis, Process Map and Solutions. It uses Streamable HTTP transport, enforces schemas before any change and supports safe retries through expected state, idempotency keys and data revision.
For ChatGPT and claude.ai the connection goes through OAuth. The Admin creates a profile with maximum role, tools and flows; the client registers itself and the user approves a consent screen showing exactly what is granted. PKCE is mandatory, effective access is the minimum between profile and current permissions, and revocation is immediate. MCP keys have an expiry preset at 90 days and never travel in the query string.
Behind every action there is a person. History shows the AI client and the key holder, and the AI cost of a case started by an agent is attributed to the key. The built-in Flow Agent, always at hand with a keyboard shortcut, works within the user's permissions and applies Data Shield. Map and solution imports from agents are preview by default, and applying requires a request identifier and explicit consent.
A typical case: an assistant connected via OAuth reads late cases, proposes starting a new one for a client and fills in the initial data. The case is born waiting; a person confirms or rejects it with a reason. History shows the assistant, the person holding the connection and the AI cost attributed to the key, so the owner knows who produced what.
For IT, the value is predictability. Schemas are enforced before any change, retries are safe thanks to idempotency, and errors return their cause. For the compliance officer, the value is readability: keys with expiry, profiles with a maximum role, consent shown to the user and immediate revocation. The agent becomes a collaborator with a job description, not a forgotten privileged access.
Related use cases
Related areas
Frequently asked questions
How many tools does the MCP server expose?
34, each with a minimum role and a read-only or destructive annotation.
From which edition is MCP available?
From Optimize, with 2 MCP keys; Automate includes 5, Enterprise unlimited.
Can an agent start cases?
Yes, within the key's whitelist, and the case is born awaiting a person's confirmation.
How is access revoked?
From settings, with immediate effect for both keys and OAuth connections.
Does the built-in Flow Agent require an MCP server?
No, it is a conversational assistant already inside FlowSharp, available from Automate; it is also exposed as an MCP tool.
