Audit and troubleshooting¶
Every call the assistant makes is written to the gateway log, so you can see what was asked, by whom, and whether it was allowed. Most refusals carry a short code that tells you what to fix.
Audit log¶
Every call, whether allowed, refused or failed, writes one line under the logger ArtekDesigner.Audit in the gateway log:
keyName=<key> user=<bound user> remote=<caller address> command=<tools/call:<tool>|initialize|…> designer=<id> outcome=<OK|DENIED|FAILED> code=<code> detail=<text>
| Field | Meaning |
|---|---|
keyName |
The API key's name. The secret never appears. |
user |
The Ignition user the key is bound to. |
remote |
The caller's address. |
command |
The tool called, or another MCP request such as initialize. |
designer |
The Designer the call went to. |
outcome |
OK, DENIED or FAILED. |
code, detail |
The refusal or error code and its explanation. |
Actions on the settings page are audited too, with the gateway user as the actor, for example command=web.settings and command=web.keys.create.
Troubleshooting¶
| Symptom | Cause | Fix |
|---|---|---|
edits_disabled |
The Enable edits master switch is off. | Turn on Enable edits on the settings page. |
no_designer with "none switched on" |
Claude is OFF in the Designer. | Switch Claude ON in the Claude panel. |
not_granted |
The key is bound to a different user, or the project is not granted to the key. | Use a key bound to the Designer's user, or add the project to the key. |
feature_off |
A start-up self-test failed in that Designer. The message says which test and why. | Report it. If the Designer runs an older version than the gateway, relaunch the Designer. |
stale |
You changed a component the batch touches since the assistant last read the view. | Have the assistant read the view again (view_read) and rebuild the batch. |
schema_invalid |
A tool argument or an operation does not match its schema. The message names it. | Correct the call. |
| HTTP 401 | No key, a wrong secret, or an unknown or disabled key. | Check the key on the settings page. |
| HTTP 429 | The rate limit was reached. | Wait the number of seconds in Retry-After, or raise the limit on the settings page. |
The panel says registered, but every call returns no_designer |
The Designer runs an older version than the gateway, or has not registered again yet after a restart. | Relaunch the Designer. Registering again after a restart takes up to 15 seconds. |
Claude Desktop log shows Dynamic Client Registration rejected (HTTP 405) |
The secret is wrong; the bridge mistakes the 401 for a login challenge. | Check the secret. The gateway audit log shows unauthorized. See Connect. |
Where the logs are¶
| Log | Where | Loggers |
|---|---|---|
| Audit | Gateway log | ArtekDesigner.Audit |
| Gateway side | Gateway log | ArtekDesigner.Gateway* |
| Designer side | In the Designer, Help → Diagnostics → Log Viewer | ArtekDesigner.Designer* |
| Claude Desktop bridge | Claude Desktop's mcp-server-artek-designer.log |