Ailimu.

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.