Help Centre / Imports and integrations / Connect Tuaneka to Codex and Claude
Imports and integrations

Connect Tuaneka to Codex and Claude

Install the official business copilot and connect one Tuaneka business in two steps.

The official Tuaneka plugin lets Codex and Claude Code manage customers, invoice drafts, storefronts, products, listings, stock, orders and deliveries through Tuaneka's secure MCP connection.

Connect in two steps

  1. Install or update the official Tuaneka plugin in Codex or Claude Code.
  2. Choose Authenticate, sign in to Tuaneka if asked, select a business and choose Connect.

Tuaneka returns you to the AI client automatically and confirms the connected business. There is no API token to copy and no environment variable to configure. Full operations is selected by default, but the agent still asks for explicit confirmation before sending invoices, recording payments, publishing a shop, changing stock or updating fulfilment.

Install in Codex

Open Settings > Connections > AI and agents in Tuaneka and choose Connect Codex. On Windows, open the small connector file that downloads. It installs or updates the official plugin, removes the obsolete token-based configuration when present and opens Tuaneka's secure sign-in. Approve the business, restart Codex once, then ask: Check my Tuaneka connection.

No GitHub visit, API token, environment variable or terminal setup is required. macOS and Linux users can use the advanced marketplace instructions while the signed desktop installer is being prepared for those platforms.

Install in Claude Code

Run:

claude plugin marketplace add teamalfy-technical/tuaneka-agent-plugins
claude plugin install tuaneka@tuaneka

Claude opens Tuaneka's secure authorization page. Select the business, choose Connect, then ask Claude to check the Tuaneka connection.

Multiple businesses

Every connection is permanently scoped to one business. Create a separately named connection for each additional business. Switching the active business in Tuaneka never silently changes an existing AI connection.

Revoke or troubleshoot

Return to Settings > Connections > AI and agents to review last use, revoke or reconnect. If the plugin is installed but says it is not connected, open its MCP settings and choose Authenticate. If authentication opens the wrong business, revoke it in Tuaneka and connect again. Manual bearer tokens remain available under Advanced manual setup only for older or custom clients.