Documentation › Connect an AI assistant
Connect an AI assistant (MCP)
An AI assistant such as Claude, GitHub Copilot or ChatGPT can work in SerenForce for you: find a process or an artifact, create one, upload a document template, change the drawing and publish it. It goes through the MCP connector of your organization and has only your rights.
What is it for?
- Find: “Which processes are about onboarding?”, “Which templates does the Employment contract artifact have?”.
- Create: an empty process (with only its start block) or an artifact with the templates you give it (Word, Excel, PowerPoint, PDF, HTML or text, with {{Name}} placeholders).
- Change: the assistant reads the drawing of a process or an artifact, changes it, saves it as a draft, then publishes it if you ask. It can also fetch a template, fix it and upload it again.
- Layout: every block the assistant draws shows its name, the people who do it and its summary, as in the editor. A new drawing is laid out by itself: steps one under the other, phases side by side, with no link running over a step. Ask “lay the drawing out again” to tidy up a process that is already drawn.
- Everything it creates belongs to you and shows in the Processes and Artifacts tabs, as if you had made it yourself. Open it in the editor to check before you publish.
Connect the assistant
- Ask your administrator for the address
It looks like https://…/api/<your organization identifier>/v1/mcp: the address of the application, followed by /v1/mcp.
- Add an MCP server in your assistant
In the settings of the assistant (connectors, MCP servers), add a server of type HTTP with this address.
- Sign in
The first time, the assistant opens your browser on the Microsoft sign-in page (the same account as for the application). Sign in and accept: the assistant then keeps you signed in and renews your sign-in by itself. If it asks for a client ID, it is the application (client) identifier of your organization: your administrator gives it to you.
- Try it
Ask: “List my SerenForce processes”. The assistant shows the ones you see in the Processes tab.
What to ask
- “Create an artifact Employment contract with this Word file.”
- “In the Onboarding process, add a description that sums up the steps, and save the draft.”
- “Download the template of the Offer artifact, replace ‘customer’ with ‘beneficiary’ and upload the new version.”
Good to know
- The assistant can do nothing more than you: it only sees the processes and artifacts you see and only changes the ones you own or contribute to. When it is not allowed, SerenForce tells it why, in your language.
- A draft saved by the assistant replaces the current draft: check it in the editor before you publish it.
- The template formats are the same as in the application: .docx, .xlsx, .pptx, .odt, .ods, .odp, .pdf, .html, .htm and .txt.
- The assistant does not start process instances and does not delete anything.
- For the administrator: the application accepts an assistant installed on the computer only at the addresses typed in AI assistant addresses (one per line, for example http://localhost/callback for Claude Code), when the platform is set up and when each organization is enrolled. Left empty, this field allows no assistant: the safest setting for an organization that uses none.
- An organization enrolled before, or whose Microsoft sign-in page refuses the return address: in the administration, open the organization, Authentication tab, AI assistants section, then Add AI assistant addresses. SerenForce adds the addresses to the Microsoft Entra ID application (Add to the application), or you download the Azure CLI script that does it (Download the script). The addresses the application already has are kept.
Permissions
- Connect: at least one of View processes, View artifacts, Create processes, Edit processes, Create artifacts, Edit artifacts or Start process instances.
- Then each request needs the same permission as in the application: View processes / View artifacts to read, Create processes / Create artifacts to create, Edit processes / Edit artifacts to save and publish; uploading a template needs Create artifacts or Edit artifacts. Users and roles explains how to get them.