Connect MCP servers to HARPA
Give the AI new tools and data through MCP servers.
On this page
An MCP server gives the AI new tools: search your docs, read a database, check the weather. You add the server once; when a question needs one of its tools, the AI calls it and answers with the result.
Each server describes its own tools, so you don't wire anything up. Ask "What's the weather in Lisbon tomorrow?" with a weather server connected, and the AI picks its forecast tool by itself.
# Add an MCP server
- Open HARPA on any page (Alt+A on Windows, Ctrl+A on Mac), click the model button in the composer and choose All connections. Alt+M on Windows or Ctrl+M on Mac opens the same Models screen.
- Scroll to MCP connections and click Add MCP server. A new card opens, filled in with the Context7 docs server as an example.
- Paste your server's address into MCP server URL. HARPA tests it as soon as you stop typing: the line under the field shows how many tools it found, or the error.
- If the server needs a key, put it in headers under Advanced settings, as a JSON object:
{ "Authorization": "Bearer your-key" }. Your server's docs name the header it expects. Replace or delete the exampleCONTEXT7_API_KEYheader. - Optionally, write a description, like "Use when asked about our product docs". It helps the AI decide when to call the tools; most models manage without it.
- Click the card's title to rename it: it starts as CONTEXT7.
The switch on the card turns the server on and off. Changes save as you type.
# Use it in a chat
Ask your question as usual. When the AI uses a server, the answer shows a line like Called 2 MCP tools.: click it to see which tools it called and with what.
MCP tools work on:
- HARPA's cloud models that can call tools, like HARPA AI: on by default.
- Your API keys: turn on MCP calls in the key card's Advanced settings, see API connections. Not every model or provider handles tool calls well, so test yours.
- Not on web sessions (ChatGPT, Claude, Gemini, Grok logins).
# Manage your servers
Under MCP connections, each row shows the server's address and its tool count, Off, or its error in red. Flip the switch to turn a server off without deleting it. Click a row, or the sliders button (Advanced settings) next to MCP connections, to edit, clone or remove servers.
# Good to know
- By URL only. HARPA connects to MCP servers over HTTP. Servers that only run as a local command aren't supported.
- Changed the headers after the test? Retype a character of the URL to test it again.
- Keep the list short. The tools of every server that's on go with each request, so turn off the ones you don't need.
- Saved to your HARPA space. Server addresses and headers sync to your HARPA space and follow you to your other devices. In a team space every member gets them, and only the space owner can change them.
- On HARPA's cloud models, each tool result goes back to the model in one more request, paid in cloud credits: see Cloud models and credits.