License and permissions
Availability of this feature depends on your license type. Before you get started, check the table below to confirm your license includes this functionality.
Find out more about Evo licenses>
Evo Standard | Evo Everywhere: Base user | Evo Everywhere: Advanced user |
❌ | ❌ | ✅ |
Connectors give the AI access to live data and systems beyond what you've uploaded to a project. Where an uploaded file is a snapshot, a connector is a live link — so the AI can fetch current information, and in many cases take action, rather than working from something that may already be out of date.
Why use a connector
Uploads give the AI a snapshot of a file. They work well when the content is stable, such as a contract, a playbook or notes from a single call. They stop working well when the content changes every day.
Connectors keep answers current. If you ask "How many open tickets does this customer have?" against an upload, you get the count from when the file was saved. If you ask the same question through a connected helpdesk, the AI fetches the live count.
Connectors can also take action. An upload is read-only, but a connector can write back to its source. You can use one to raise a ticket, move a candidate to the next stage or start a workflow.
The four types of connector
You add all four types from the Connectors tab in a project. The Add connector wizard shows only the steps that apply to the type you choose.
Type | What it does | Example |
Evo product connector | Connects to another Evo product and makes its skills available to the AI as tools | The CRM, the HRIS, Data Spaces |
Third-party connector | Connects to an external service. You sign in with your own account | A cloud storage or work management tool |
Assistant Builder assistant | Uses an assistant built in Assistant Builder as a tool | A triage assistant your team has built |
Custom (MCP server) | Connects to any server that supports the Model Context Protocol (MCP) | An internal service your team has set up with MCP |
Which connectors are available
The connectors you can see depend on your organisation's setup and region. Open Add connector to see the options available to you.
Evo product connectors: Data Spaces, plus internal Evo products such as the CRM, HR, helpdesk and recruitment tools.
Third-party connectors: External services. The first time you use one in a project, you sign in with your own account. Your access stays separate from other people's.
Assistant Builder assistants: Any assistant your organisation has published in Assistant Builder. Researcher fetches these when you open the wizard.
Custom connectors: Any server that supports MCP over Streamable HTTP. See Connect a custom MCP server below.
If a connector you need isn't listed, it may not be set up for your organisation or region yet.
Connectors added automatically
Some connectors appear in a project without you adding them. Data Spaces works this way when the project has data spaces selected.
The connector is added for you and labelled "Added automatically because this project has data spaces picked".
The connector has no remove button.
If a connector is enabled for your organisation but its product isn't yet live in your region, it stays hidden until it is.
Set up default connectors
You can set up default connectors that are added to every new chat and project. For example, you might want Data Spaces available everywhere.
Open user settings.
Select Connectors.
Add a connector to your defaults, or remove one.
Set up a connector
The flow is the same for all four types. The configuration step changes depending on the type you choose.
You need access to the project. For a custom connector, you also need the server URL and any sign-in details your IT team provides.
Open the project, then select the Connectors tab. It's the plug icon on the right-hand side.
Select Add Connector.
Choose a type: Evo Product Data, Assistant, 3rd Party or Custom.
Configure the connector:
Evo Product Data: Choose the skills the AI is allowed to use. If more than one instance of the product is available to your organisation, choose the instance this connector should use. The AI's calls are then limited to that instance.
3rd Party: Sign in with your own account.
Assistant: Choose an assistant from your organisation's list.
Custom: Enter the server URL and any custom headers. See Connect a custom MCP server below.
Select Save. The connector is now one of the tools the AI can choose from in this project.
Each connector shows a status badge in the list. If the badge shows an error, check the server URL and your sign-in details, then retry from the list.
How the AI uses a connector
The AI doesn't check connected systems in the background. Each connector gives the AI one or more tools it can call when your message needs that data.
For example, if you ask "What's open for this customer in the helpdesk?", the AI:
Recognises that it needs helpdesk data.
Calls the tool that lists that helpdesk's tickets, named something like evo_mcp_helpdesk__listTickets.
Summarises the result for you.
The chat shows which tool was called and whether the call succeeded or failed. Every connector call is also recorded for the AI Platform team's debugging. End users don't see these records.
Every connector you add is another option the AI considers on every message. Add the connectors your work needs and leave the rest off.
Choose the right connectors
Add the connectors your work needs and leave the rest off. A template with many connectors gives the AI a wider set of tools to pick from, which can lead to more wrong choices.
Use an Evo product connector when the data lives in another Evo product. Use a custom connector when it lives anywhere else.
Approve changes made through a connector
Some connector actions change information in another product, such as creating a record or updating a status. Before the AI makes one of these changes, it stops and shows you an Approval needed card.
Actions that only read information, such as searching or listing, usually run without asking. The connector's owner can change this for each action.
Respond to an approval card
The card names the connector and the action, and explains why the AI is asking. Select Show details to see more about the call. Nothing runs until you choose one of these options.
Option | What it does |
Allow for this answer | Runs the action for the rest of this answer only. If the AI needs the same action again in the same reply, it won't ask twice. Your next message starts fresh, and it will ask again |
Always allow in this project | Runs this action and stops asking for it in this project |
Deny | Stops the action. The AI carries on without it, or tells you it can't proceed. No rule is saved, so the action can be offered again later |
If your organisation has turned on wider approval choices, the dropdown next to Always allow in this project also offers Always allow [connector] in this project and Allow everything in this project.
A standing permission applies to one action, in one project, for one person. Allowing a search doesn't allow a delete. Once you allow an action, the AI runs it without asking, including actions that send, change or delete information. Use the wider options only for connectors you fully trust.
A different action on the same connector still asks the first time it comes up. In a standalone chat, the chat counts as the project. A workflow that makes many different changes asks several times, then settles down as the common actions are approved.
In a shared chat, an approval card belongs to the person whose message the AI is acting on. Other people viewing the chat can't approve it for them.
Turn off approval prompts for a project
If your organisation has turned on wider approval choices for you, you can stop the AI asking before each change in a project.
Select the shield icon in the composer.
Select Allowing everything.
To turn prompts back on, select the shield icon again, then select Ask before changes.
Before each change, the AI still runs a check that compares the action with your request, and blocks anything you didn't ask for. The shield icon shows which mode you're in.
Set up approvals for your organisation
A Researcher admin sets the wider approval choices for the whole organisation. A Connector Author can also set the approval rule for each tool in an organisation connector.
Open the Admin area.
Select Settings.
Select Wider approval choices, then select Configure.
Choose one of the options below.
Option | What it allows |
Off | People approve each action, or always allow one action |
Everyone | Anyone in the organisation can always allow a whole connector |
Chosen people | Only the people an admin selects can always allow a whole connector |
The connector's owner has the final say on whether a tool asks for approval. A read-only operation can be set to require approval, and a write can be set not to require it. For an organisation connector, the Connector Author sets this for each tool.
Wider approval choices apply per project and per person. Each collaborator approves for themselves, because connector calls run under each person's own credentials.
Review or remove standing permissions
Open Settings.
Select Chat Approvals.
Find the permission you want to change, then remove it.
The change takes effect immediately. The next time that action comes up, the AI asks again.
Privacy and access
How a connector handles sign-in depends on its type. This matters when you share a project with collaborators.
Connector type | How sign-in works |
Evo product | Handled by the platform. Your access reflects your own permissions in the Evo platform |
Third-party | Each collaborator signs in with their own account. The AI acts for the person using the project, not the person who set up the connector |
Assistant Builder assistant | Handled by the Assistant Builder integration |
Custom | Either a shared credential saved on the project, or sign-in for each person. This depends on how the server was configured |
Tokens and keys you enter yourself are used only for your account. OAuth sign-ins are always personal.
Templates include the connector setup but not anyone's sign-in details. Each person who creates a project from a template signs in for themselves.
Connect a custom MCP server
A custom connector lets you connect Evo Researcher to any service that supports the Model Context Protocol (MCP). Use one when the data or action you need lives outside Evo and no third-party connector covers it.
The server must be hosted remotely, reachable over the internet using HTTPS, and must use the Streamable HTTP transport. Servers that support only SSE aren't supported.
Requests to custom servers come from Evo Researcher's cloud servers, not from your computer. Evo Researcher can't reach a server running on your own machine or local network, including a server that gives access to local files. To work with files on your computer, add them as an upload instead.
Select Add Connector, then select Custom.
Enter a name and the server URL.
Choose how Evo Researcher signs in to the server. See the authentication methods below.
Add any custom headers the server needs.
Select Save. Evo Researcher tests the connection automatically.
When you save a custom server, Evo Researcher connects to it and lists its tools to confirm it works. The badge shows the result. A failing badge usually means the URL is wrong, the server can't be reached, or the credentials were rejected. You can retry from the list.
You can save a custom server to your personal library and reuse it across projects, or add it to a single project.
Authentication methods
Method | How it works |
None | No credentials are sent. The badge reads No auth required |
Bearer token | Evo Researcher sends your token in the Authorization header. You paste the token when you connect. It's stored encrypted and used only by you |
API key | Evo Researcher sends your key in a header. The default header is X-API-Key, but you can name any header the server expects |
OAuth | You sign in through the provider and approve access. You don't paste anything. Used by servers such as Atlassian, Linear, Notion and GitHub |
Add custom headers
Custom headers are key and value pairs sent with every request. Everyone on the project shares them. Use them for anything the server needs on top of authentication, such as an organisation ID.
You can add up to 25 headers.
You can't use the header your authentication method already uses, any header starting with evox-, or mcp-session-id.
Connect an OAuth server
You don't set up any OAuth details yourself. Evo Researcher finds them from the server. You only enter the server URL and choose OAuth.
Add or edit the connector, choose OAuth, then select Save. Saving doesn't sign you in yet.
In the Your credentials section, select Connect account.
Sign in and approve access in the pop-up window.
Check that the badge shows Connected.
Your connection belongs to you, on this project. A template never shares an OAuth connection, so each person who uses it connects their own account.
Evo Researcher acts as the app you sign in to. It never sees your provider password. It keeps the connection alive by refreshing it in the background. If it can't, for example because the provider issued no refresh token or the connection was revoked, the badge shows Reconnect. Select Connect account again to sign in. To remove your stored connection, select Disconnect.
Some providers won't accept a new application until an administrator has registered the Evo Researcher callback URL. If so, you'll see an error that names the problem and shows the callback URL to give your administrator.
The Connector Author role
Connector Author is an organisation-level role in Evo Researcher. Like the other delegated roles (such as Org Author, App Author/Publisher and Org Settings), it is granted by an organisation's admin rather than by the Evo platform, so it hands one specific area of org administration to someone without giving them full admin rights. Its purpose is to let a trusted person own the organisation's custom connectors.
A Connector Author can:
Create, edit and delete the organisation's custom connectors.
See each connector's usage — how many projects, templates and library entries link to it — and review its change history.
Manage the connector's tools: refresh the list of tools the connected server exposes, choose which tool names are made available, and set the approval rules around them.
Because a connector is only useful once the organisation decides how its tools are governed, the role reaches a little beyond connector setup itself. In the admin area it also unlocks the Chat Approvals section and a focused view of Org Settings limited to the organisation-wide tool-approval choices. In short, it is a "owns the organisation's connectors and the approval policy around them" role, scoped so connector management can be delegated without granting broad administration.
How a user sees and uses it
Everything the Connector Author does happens in the admin area, which a normal user never sees — the Custom Connectors section only appears for someone who holds the role. What a normal user gets instead is the result of that work, surfaced on a project's Connectors tab. The connectors an organisation has published are visible to every member, even though only a Connector Author can create or change them.
To use one, a normal user:
Opens a project and goes to the Connectors panel.
Clicks Add connector → Custom. When the organisation has connectors, the first step is a searchable list of the ones the Connector Author has set up — each shown with its name, description and authentication method.
Picks the connector they want and adds it to the project. (There is also a "Set up your own" option for anyone who wants a one-off connector of their own.)
The shared definition — the connector's address, authentication method, the tools it exposes and their approval rules — is read-only to the normal user; it was configured once, centrally, by the Connector Author. What the user supplies is their own connection: depending on the connector, they either enter their personal token or credentials into the fields the connector asks for, or sign in through OAuth. This is a "connect once" design — the credential belongs to the individual, is scoped to them, and works wherever a live copy of that connector exists, so they don't have to reconnect per project.
The result is a clean division of labour: the Connector Author builds and governs each connector for the whole organisation, and a normal user simply picks it from the list and plugs in their own credentials to start using its tools in chat.
