Connecting Claude
After publishing, the wizard shows the address, the token and the exact commands. This page is the same thing, for reference.
The address
Each profile has its own endpoint and its own token:
http://your-server:8081/mcp/<profile>
The bare /mcp also works when the connector holds exactly one profile, which is
why an install that predates profiles keeps working.
The token grants access to whatever you exposed. Treat it as a password. A different profile's token will not open this one.
If Claude runs on another machine, localhost will not do: use the server's LAN
address or hostname, and make sure the port is reachable.
Claude Code
claude mcp add --transport http sales http://your-server:8081/mcp/sales \
-H "Authorization: Bearer YOUR-TOKEN"
Then type /mcp in Claude Code. You should see sales connected, with the number
of tools the wizard reported.
Claude Desktop
Add to claude_desktop_config.json and restart:
{
"mcpServers": {
"sales": {
"type": "http",
"url": "http://your-server:8081/mcp/sales",
"headers": { "Authorization": "Bearer YOUR-TOKEN" }
}
}
}
What the agent receives
A table called invoices and a script exposed as recalculate_totals produce:
| Tool | What it does |
|---|---|
get_invoices |
One record by its identifier. Every readable field. |
find_invoices |
Search. Returns the identifier plus the searchable fields, and the total match count. |
describe_invoices |
The fields a search cannot filter on, and how this table links to others. |
update_invoices |
Change a record. Only exists when writes are enabled and read-only is off. |
recalculate_totals |
One exposed FileMaker script. Only exists when read-only is off. |
Each tool carries a description built from your FileMaker field comments, the row count captured at discovery, the syntax each parameter accepts, and: for a foreign key: the name of the tool that resolves it. That description is why the agent selects the correct tool rather than guessing.
Searches accept more than equality:
| You want | Write |
|---|---|
| On or after a date | >=2024-03-01 |
| Between two dates | 2024-03-01..2024-03-31 |
| Greater than a number | >1000 |
| Text containing | smith |
| Text exactly | =Smith |
| An identifier, partially | ~a1b2 |
Criteria combine with AND. A search returns 50 rows unless you ask for more, along with the total number of matches.
After you republish
The server updates immediately; a connected client does not. Start a new session.
You do not need to run claude mcp add again.
Several files at once
Two profiles means two entries in your client config, each with its own URL and token. Prefer a single profile with Run scripts from set when what you actually have is one solution split into a data file and an interface file: see the wizard.