Start a conversation

Connect your own server or tool (MCP)

Connect your own server or tool (MCP)

If your company runs a system the assistant should look things up in, such as a ticket system, an internal database or a custom application, you can connect it through an MCP server or API. The assistant reads it live when it answers and never copies it, so it sees whatever the server holds at that moment. On the Knowledge tab the connection appears as a Live system.

For HubSpot, Salesforce, Kayako and Zendesk there are ready-made connections. Use this article for a server you run yourself.

Two kinds of tool

When Eloquens connects to a server, it reads the list of tools the server offers. Each tool is marked in one of two ways:

  • Knowledge: Eloquens can call the tool on its own while it looks for an answer to an email, for example to search documentation, find a customer record or check an order. It does not wait for a decision first.
  • Action: the tool does something in the other system, such as creating a ticket or updating a record. Eloquens uses it only when it decides that a particular email calls for it.

Eloquens first marks each tool by looking for words in its name, such as get, search or list (Knowledge) and create, update or delete (Action). A tool whose name does not clearly point either way is marked Knowledge. You can change each mark, as described below.

The mark only decides when Eloquens calls a tool. It does not make the tool read-only. Eloquens does not check what a tool can do on the server. A tool that can create or change things in the other system can still do it when it is marked Knowledge, and Eloquens may call it while it looks for an answer. To keep a connection lookup-only, turn off the write actions of its tools on the server itself, or connect a read-only tool or server, and mark only lookup tools as Knowledge.

Connect a server to an assistant

  1. In the left rail, click My Assistants, open the assistant and click the Knowledge tab.
  2. Click Add knowledge. The window is titled with the assistant's name, for example "Give Sally something to read".
  3. Choose Anything with an MCP server or API (the line under it reads Your own connector). You can also type MCP in the search box.
  4. Under Your own, fill in Name, for example Our ticket system.
  5. Enter the Server address. Your server's provider gives you this, and it often ends in /sse.
  6. Under How you sign in, choose With an API key or By signing in to the service. If the service can be detected as one that uses sign-in, Eloquens chooses that for you and shows "Detected automatically".
  7. If you chose an API key, paste it into API key.
  8. In AI instructions (optional), say when the assistant should use the server and anything it should be told.
  9. Click Connect.

Eloquens then checks that the server answers ("Checking the server answers…") and reads the tools it offers ("Reading the tools it offers…"). When it works you see "Connected" with the number of tools the assistant can use. The server is attached to this assistant straight away.

If you sign in to the service

Choose By signing in to the service and you do not need an API key. Clicking the button opens the service's own sign-in page so you can allow access, and then Eloquens checks the connection. If the service needs your own client details, click Advanced: use my own client credentials and fill in Client ID (optional) and Client secret (optional). Leave both blank otherwise.

If the key goes somewhere unusual

Most servers expect the key in the usual place, so you will not need to change anything. If yours is different, click Advanced under the API key. In Where the key goes choose:

  • Authorization header (usual).
  • A different header, then type the Header name.
  • Part of the web address, then type the Name in the address.

How you sign in cannot be changed after the connection is created. To use a different method, delete the connection and add it again.

Write good AI instructions

  • Say what the server is for: "Use this for customer account lookups."
  • Say when to use it: "Search this when someone asks about technical documentation."
  • Say what not to do: "Only create tickets for bugs, not feature requests."

Manage your connections

The Connections page lists everything you have connected. To open it, click Connections in the line under the Connect button, or click the name of a Live system on an assistant's Knowledge tab.

Under Connectors, each connection is a card with a status:

  • Active: connected and ready to use.
  • Not connected: a connection that uses sign-in has not been authorized yet. Click Connect to finish.
  • Not validated: the connection has not been checked yet. Click Validate to check it and load its tools.
  • Failed: the last check did not work. Click Retry, or edit the connection to fix its key.
  • Authorization expired or Credentials expired: click Reconnect or Update credentials.
  • Disabled: turned off. Click Enable to turn it back on.

To add another server from this page, click Add connector, then Add a custom connector. The window Add MCP Connection asks for Name, Server URL, Authentication and, for key-based options, the API Key.

Check what a server offers and change how a tool is marked

  1. On the Connections page, click the connection's card. The window Connector tools lists each tool with its Name, Description and Classification.
  2. Change a tool's classification between Knowledge and Action. This changes only when Eloquens calls the tool, not what the tool can do.
  3. Click Save.

If the card says there are no tools, open the card's Connection menu and click Validate & discover to read the tools again. You can also use it any time to check that the connection still works.

Edit, turn off or delete a connection

Open the card's Connection menu.

  • Edit connection: change the name, address, instructions or key. Saved keys are hidden, so type a key only if you want to replace the saved one.
  • Reconnect (OAuth): sign in again for a connection that uses sign-in.
  • Disable connection or Enable connection: turn it off or on without removing it.
  • Delete connection: confirm in Delete connection?. The connection is removed and disconnected from every assistant that used it.

To stop just one assistant using a connection, open that assistant's Knowledge tab and click Stop reading on the connection's row. The connection stays in your workspace.

Tips

  • Check the mark on every tool after you connect a server. Mark a tool Knowledge only if it looks things up and changes nothing, because that mark does not stop a tool from writing. Mark a tool Action when it changes things in the other system and you want Eloquens to call it only when an email calls for it.
  • Give each connection a clear name and instructions, so the assistant picks the right one when you connect more than one.
  • Do not connect two servers that hold the same information.
  • Rotate API keys from time to time. Use Edit connection to replace the key.
  • Connections belong to the workspace. Each assistant that should use one needs it added on its own Knowledge tab.
Choose files or drag and drop files
Was this article helpful?
Yes
No
  1. Soma Konate

  2. Posted
  3. Updated

Comments