Connect an AI assistant¶

Your assistant talks to Artek-Designer over MCP through one gateway address, using the API key you created in Configure.

Endpoint and authentication¶


Endpoint	`POST http://<gateway>:<port>/data/artek-designer/mcp`
Header	`Authorization: Bearer <keyName>:<secret>`
Alternative header	`X-Artek-Designer-Token: <keyName>:<secret>`

Replace <gateway>:<port> with your gateway's address, and <keyName>:<secret> with your key's name and secret. Ignition's own API tokens are not accepted.

Claude Code¶

claude mcp add --scope user --transport http artek-designer \
  http://<gateway>:<port>/data/artek-designer/mcp \
  --header "Authorization: Bearer <keyName>:<secret>"

Codex CLI¶

Add this to ~/.codex/config.toml:

[mcp_servers.artek-designer]
url = "http://<gateway>:<port>/data/artek-designer/mcp"
http_headers = { Authorization = "Bearer <keyName>:<secret>" }

Claude Desktop¶

Claude Desktop's custom connectors run from Anthropic's cloud and cannot reach a gateway on your local network. Instead, declare a local bridge with mcp-remote. This needs Node.js on the PC.

In Claude Desktop, open Settings → Developer → Edit Config.

Add this entry under mcpServers in claude_desktop_config.json:

"artek-designer": {
  "command": "npx",
  "args": ["-y", "mcp-remote", "http://<gateway>:<port>/data/artek-designer/mcp",
           "--allow-http", "--header", "Authorization:${AUTH}"],
  "env": { "AUTH": "Bearer <keyName>:<secret>" }
}

Quit Claude Desktop completely and start it again.

Notes:

--allow-http is required when the gateway URL is plain http.
The ${AUTH} form keeps Windows from breaking the space inside the header value.
If the secret is wrong, Desktop's mcp-server-artek-designer.log shows Dynamic Client Registration rejected (HTTP 405), because the bridge mistakes the gateway's 401 for a login challenge. The gateway's audit log shows the real cause, unauthorized.

First call: designer_status¶

In your assistant, have it call designer_status first. It reports:

the module version and whether edits are enabled,
the user the key is bound to and the projects it is granted,
that user's open Designers, with each one's Claude switch and start-up self-test results.

The assistant also receives instructions when it connects, and can read the artek-designer://guide resource for how to work. The designer_session_start prompt opens a working session.

Next step¶

Use it in the Designer.