MCP server

An MCP server offers tools that an AI can call, for example to look up an order or check opening hours. When you connect your MCP server as a source, chat in your widgets can call the tools you allow.

Connect your MCP server

1. Go to Sources and click Add new source
2. Select MCP server and click Next
3. Under Connect your MCP server, fill in:
   • Server URL, the address of your MCP server, e.g. https://example.com/mcp. The server must use the Streamable HTTP transport.
   • Access token, if your server needs one. Raffle sends it as a Bearer token in the Authorization header. Leave it empty if the server needs none.
4. Click Create

Raffle connects to the server and reads the tools it offers. Nothing is saved until the connection works. If it doesn’t, you see Could not connect to the MCP server. Check the URL and the access token.

Tools

When the server is connected, its Tools page lists every tool the server offers, with its name and description. Click a description to read all of it, and use Search by name or description to find a tool.

To open it later, find the server on the Sources page and click View tools.

Listing a tool here doesn’t turn it on. Chat can only call the tools you enable for a widget.

Let chat use the tools

1. Go to Widgets and open the widget
2. Open the Sources tab
3. Under MCP tools, turn on the tools chat may call in this widget, then save

The tools are only used when chat is on for the widget. Two tools with the same name can’t both be on in one widget. A tool the server no longer offers is marked No longer offered. See Widget sources.

Settings

Click Settings on the server’s Tools page, or in the server’s options on the Sources page, to change:

• Server URL
• Access token: type a new token to replace the current one, or leave it empty to keep it. Click Remove token to remove it.

Click Update to save.

Delete an MCP server

On the Sources page, open the server’s options and click Delete, then confirm. Its tools are removed from every widget.