Connect an assistant

Create an API key

The MCP server uses the same workspace API keys as the REST API. Only owners and admins can create them.

1. Sign in to app.tirver.com.
2. Open Settings, API keys and create a key.
3. Choose its scopes. For a read-only assistant pick only the read scopes. To let it leave draft replies, create drafts and file feedback, add conversations:write, help-center:write or feedback:write. See permissions.
4. Copy the key straight away. It is shown once.

Treat the key like a password.

Add the server

Most clients accept a server address and a header. The values are always the same.

claude mcp add --transport http tirver https://app.tirver.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

{
  "mcpServers": {
    "tirver": {
      "type": "http",
      "url": "https://app.tirver.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "tirver": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.tirver.com/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]
    }
  }
}

Restart the client after you edit its configuration.

Check that it works

Ask the assistant something that needs your workspace, for example: “Search the Tirver help center for how to install the widget.” The assistant should call search_articles and answer from what it finds. If it does not list Tirver among its tools, see the troubleshooting list below.

Troubleshooting