Увійти
How to connect an AI agent to a Shopcore store

How to connect an AI agent to a Shopcore store

Secure access to approved store actions without access to code or the server.

Shopcore AI API gives an agent access only to documented store actions. It does not expose Python, the database, the file system, or backend access. MCP is not required: give a trusted agent the complete prompt shown during onboarding.

Connect an agent

  1. Open AI agent access during new-store onboarding.
  2. Choose Copy everything for AI and paste the prompt into Codex, Claude, or another trusted agent.
  3. Ask the agent to fetch the method catalogue before it performs any action.

The prompt contains the exact Hive URL, key identifier, and token for your store. Access can later be managed under Site settings → AI agent access.

API flow

GET https://<your-hive-host>/ai/v1/methods/
Authorization: Bearer <your-token>
POST https://<your-hive-host>/ai/v1/invoke/
Authorization: Bearer <your-token>
Content-Type: application/json

{"method": "system.status", "params": {}}

Use the exact URL included in the Shopcore prompt. The current catalogue describes available method names, parameters, and risk levels. Initial methods include system.status, product list/details, page list, and site-name update.

Security

Start with read-only, lower-risk methods and verify the store context before changing anything. API responses include status, store context, and a request_id; calls are recorded in the audit log.

  • The full token is shown only when it is created or regenerated.
  • Regenerating a token invalidates the previous token immediately.
  • The AI access toggle blocks all calls when disabled.
  • 401 means invalid credentials, 403 means access or billing is blocked, and 404 means a method or resource was not found.

AI API is available on current plans except Start; Personal follows its trial terms.