MCP and keys
Connect an AI assistant, like Claude or Cursor, to your Woise account so it can read and build your agents for you.
Open MCP in the sidebar, under Developer. The page has two parts: the Server address your assistant connects to, and the Keys it signs in with.
Connect an assistant
Create a key
Select Create New Key, give it a Key Name you will recognise later, such as the tool or computer that will use it, and select Create Key.
The key is shown once, in API Key Created Successfully. Copy it and keep it somewhere safe. You can't see it again, so if you lose it, delete it and create a new one.
Copy the server address
Under Server address, select Copy address.
Add it to your assistant
In your assistant's MCP settings, add a server with that address and send the key in either header:
X-API-Key: <your key>Authorization: Bearer <your key>
What the assistant can do
With a key, an assistant can only work inside your account. It can:
- List your agents and read how each one is built.
- Create an agent, and edit one. Edits are saved as a draft, so your published agent doesn't change until you select Publish in the app.
- Look up the step types and the guide to writing voice prompts.
- List runs and read a single run, and list recordings.
- List your tools, knowledge base documents and saved credentials. For credentials it only sees the name and type, never the secret.
A key also lets your own systems send contacts to an outbound campaign whose source is Webhook. See Campaigns.
Keys
The Keys list shows each key's name, its first few characters, when it was created and when it was last used. To remove a key, select its delete button and confirm. A deleted key stops working at once.
A key gives access to your account. Keep it in a password manager, never in a shared document or in code, and delete it if someone else may have seen it.
Good habits
- Create one key for each tool or person that uses one, so you can remove one without breaking the others.
- To replace a key, create the new one first, move the tool onto it, then delete the old one.
- Delete a key as soon as nothing uses it.
Common questions
What is MCP?
A way to connect an AI assistant, like Claude or Cursor, to your Woise account so it can read and build your agents for you.
How do I create a key?
Open MCP in the sidebar under Developer, select Create New Key, give it a name, and copy it when it is shown. You cannot see it again.
What can an assistant do with a key?
List and read your agents, create and edit them as drafts, read runs and recordings, and list tools, documents and credential names. It never sees a credential's secret.
Will an assistant change my live agent?
No. Edits are saved as a draft, so your published agent does not change until you select Publish in the app.
How do I remove a key?
Select its delete button and confirm. A deleted key stops working at once.