Skip to main content
Agents are built in Agent Studio; this tab holds the account-level things they depend on — the credit balance, the outside tools they may call, and the endpoint that lets another system start them.

What this tab controls

The page is headed AI settings — “Agent Studio credits, connected tools (MCP), and agent-to-agent access.” It also holds the Note assistant card — which assistant drafts your notes and the AI Note Taker’s recordings. See Choose a note assistant for what it does and, for EvidenceMD specifically, the eligibility your clinic needs: an active API add-on (or an Enterprise agreement) and the current API data agreement accepted, both from Settings → API access.

Agent credits and automatic top-up

  • Use agent credits when AI Note Taker minutes run out is on by default. With it on, each AI Note Taker minute beyond the plan’s included minutes costs 2 credits. With it off, AI Note Taker stops when the included minutes run out.
  • Automatic top-up is off by default. The owner opens Edit and chooses the pack, the balance that triggers a purchase (starts at 200 credits) and the most purchases in a month (starts at 3). The card on your subscription is charged and credits are added once the payment succeeds. A failed payment pauses it, and the card says why with Turn back on for the owner. A manager sees the state with “Only the clinic owner can change this.”
  • AI Rewrite and AI Autocomplete use credits too, and are paid-plan only.
Rates, packs and the details are in AI credits.

Connected tools

Only an owner or manager can add a tool, reconnect it or remove it; everyone else sees the list and can pick a tool for an agent, but the add, Reconnect and remove controls are not shown to them. If someone tries anyway they see “Only an owner or manager can add or remove a connected tool.” Where your clinic requires two-factor sign-in, the session must have passed it.

Webhook / API trigger

Every agent step consumes credits from the hospital’s balance. A webhook wired into a busy system can fire agents far more often than anyone expects, so turn it on knowing what will call it and how often — and disable it while you are testing the sending side. Credits are covered in Agent credits.

Set it up

1

Check the credit balance

The Agent credits card shows what is left. An agent with no credits will not run.
2

Connect an external tool

Select Add MCP server, name it, paste its URL, and pick the auth it needs. Use Test first — it reports the tool count and names, so a wrong URL is caught before you save.
3

Authorise it

For OAuth, choose Add & Connect and sign in through the window that opens. It confirms with “MCP server connected”. Later, the connection renews its own sign-in; if the server stops accepting it, Test tells you to reconnect and Reconnect signs you in again.
4

Open the Webhook / API trigger card

Expand it. It explains itself: “Give this endpoint to Zapier, a form backend, another app, or any script.”
5

Copy the endpoint and the secret

Copy the Endpoint URL, then Reveal and copy the Signing secret into the sending system as SIGNING_SECRET. Use Copy snippet for the exact signing recipe.
6

Enable it

Switch the endpoint to Enabled. It confirms with “Webhook endpoint enabled”.

When a connected tool does not respond

Test names the problem instead of a general failure:
  • “The server refused the sign-in. Reconnect it in Agent Studio.” The tool no longer accepts your sign-in. Select Reconnect (OAuth) or paste a fresh token.
  • “Could not reach the server.” The address is wrong or the tool is down. Check the address, then try again.
  • A message from the tool itself, such as a request it did not understand. Check the tool’s own settings.
EvidenceMD needs the API add-on and the agreement. To connect EvidenceMD as a tool, your clinic needs the API add-on (or an Enterprise agreement) active and the current API data agreement accepted, both from Settings → API access. Without them, adding, testing or running EvidenceMD is refused with a message saying which one is missing, with a link to Settings → API access. A connection you made earlier is not deleted; it works again once both are in place. This is the same eligibility as the note assistant.

What changes once you save

Connecting a tool makes it selectable as a step in Agent Studio. Nothing calls it until an agent is built to. When it is called, identifying details are stripped before anything reaches a third party — the tool sees the shape of the request, not the patient behind it. Removing a server takes it away from every agent immediately; an agent that depended on it fails that step rather than silently skipping it. Enabling the webhook opens a single endpoint. A correctly signed POST fires every published agent whose start trigger is “Webhook / API call” — or a custom event matching the request’s event field — and the JSON body becomes that run’s input. The important consequence runs the other way: a webhook-triggered agent will not fire at all until the trigger is enabled here. An agent can be published, correct and waiting, and nothing happens because this switch is off. Check it first when a trigger appears dead. Rotating the secret takes effect instantly. “The current secret stops working immediately. Any external system signing requests with the old secret will start getting 401 errors until you update it with the new secret.” Rotate when someone leaves, or when the secret has been pasted somewhere it should not have been — then update every sender. Requests older than five minutes are rejected, and a repeat carrying the same idempotency key is treated as a duplicate rather than run twice. Agent behaviour itself is set per agent in Agents, not here.

Check it worked

A connected tool shows in the list with its URL and, for OAuth, a green OAuth badge. For the webhook, send one signed test request from the outside system: the agent should appear in its run history with your JSON as its input, and the credit balance should drop by what that run cost.

Common issues

“Let any external system (Zapier, a form backend, another app) fire your agents by POSTing a signed request to your clinic’s webhook endpoint. Available on the Team plan.”
Accountants can reach settings but not the trigger card.
Either the signature does not match, or the secret was rotated and the sender still holds the old one. Re-copy the secret and re-check the signing snippet.
No published agent has “Webhook / API call” as its start trigger, or its custom event does not match the event in your request body.
The URL is wrong or the server needs auth you have not supplied. Switch to Bearer token or OAuth and test again.
Its authorisation expired. Select the refresh icon on the row and sign in again.
Your clinic needs the API add-on (or an Enterprise agreement) and the current API data agreement accepted, both from Settings → API access. The card names exactly which one is missing. If EvidenceMD was working and has since paused, notes draft with ClinikEHR in the meantime — your EvidenceMD key is kept, and drafting resumes automatically once this is resolved.