AI Agent Connections
Connect Claude Code, Hermes Agent, OpenClaw or another MCP/A2A client to your Shopfront seller agent
Shopfront provides a read-only seller agent that can answer questions about your inventory, listing health, recent sales, analytics, connected channels and Shopfront documentation.
The connection delegates questions to Frank. It does not expose Shopfront's internal database tools and cannot create, edit, list or delist products.
Connect an agent
Create a restricted token
Go to Settings → Workspace → AI Agents, select Connect agent, name the connection and choose a 30- or 90-day expiry.
Copy the token once
Store the token securely as SHOPFRONT_AGENT_TOKEN. Shopfront stores only its hash, so the full token cannot be shown again.
Copy your configuration
Use the separate Copy config button for Claude Code, Hermes Agent or OpenClaw. The configuration points to the environment you are currently using and reads the token from SHOPFRONT_AGENT_TOKEN.
Protocol endpoints
- MCP Streamable HTTP:
/api/agent/mcp - A2A JSON-RPC:
/api/agent/a2a - A2A Agent Card:
/.well-known/agent-card.json
The MCP server exposes one tool: delegate_to_shopfront_agent. Pass a query and, optionally, the conversationId returned by a previous call.
Security and audit
The bearer token deterministically resolves one Shopfront workspace in server code. A model cannot supply or change the organisation ID. Each delegated query, tool interaction, outcome and final response is recorded in the same generic agent session, run and event history used by Frank in the Shopfront web app. Plaintext tokens, chain-of-thought and buyer personal information are not recorded.
Revoke a connection from Settings → Workspace → AI Agents if a token is lost or no longer needed.