> Every page of the Heythere docs is listed in https://heythere.io/docs/llms.txt: fetch it to find a page instead of guessing its URL.

# MCP servers: let an AI step use your help center or shop

> Let an AI agent step search your help center or read an order through a service's MCP server, once a member connects it for the workspace.

A customer asks the online shop "Where is my Ember jacket?", and its AI agent step needs the order to answer. An MCP server is a service's endpoint, such as `https://mcp.notion.com/mcp`, that offers tools to AI models, such as searching a knowledge base or reading an order. An `ai_agent` [step](https://heythere.io/docs/concepts/steps) can call the tools of a remote server, as it calls `http_request` tools.

Heythere itself calls the server, whatever the step's [AI](https://heythere.io/docs/concepts/ai) provider, so every call appears in the [workspace log](https://heythere.io/docs/concepts/workspace-log) and a tool declared as `writes` is never called twice for the same inputs.

## How does a step use a server?

`listMcpServerTools` lists what a server offers. The step enables only the tools it needs, each an `mcp` tool naming the server's URL, the tool, and its input schema. The [version](https://heythere.io/docs/concepts/versions) a member publishes keeps that description. When the server later changes a tool, the step still calls it, and the log notes the change.

## Who connects a server?

A server either needs no sign-in, or reads a token. The token comes from headers that read a [secret](https://heythere.io/docs/concepts/secrets), or from a connection a member makes once for the workspace by signing in to the service, on the MCP servers page of the console. The connection acts as that member's account at the service, stays when they leave the workspace, and is deleted on the same page. An agent never sees its tokens, only `listMcpServerConnections`.

## What happens when a server is not connected?

`getAutomation` and `replaceAutomationDraft` return `missingMcpServerConnections`, with one console link connecting them all, which the agent gives the member. Testing or publishing such a draft fails with a conflict carrying the same link, and the Test pop-over offers to connect each server. A step whose connection was deleted, or whose server refused its tokens for good, tells its model the business has not connected the server, until a member connects it again.

## In the API

Every operation is a REST endpoint and, unless marked REST only, an MCP tool of the same name. [The OpenAPI document](https://app.heythere.io/api/openapi.json) describes their parameters, payloads, and errors.


- `listMcpServerTools`: List an MCP server's tools. `GET /api/organizations/{organizationId}/workspaces/{workspaceId}/mcp-server-tools`
- `listMcpServerConnections`: List MCP server connections. `GET /api/organizations/{organizationId}/workspaces/{workspaceId}/mcp-server-connections`
