Connect the local AI clients on this computer.
Use the guarded codex-config workflow for a Codex-backed client. Use client-config <client> for another candidate. Every entry is local and key-free.
Before configuring any client
tentaclaw-mcp init
tentaclaw-mcp status
tentaclaw-mcp doctorThe local server reads its own per-user configuration. Do not add the Poppy key or key-file path to any client configuration.
Codex CLI 0.145.0, Codex IDE, and the same local Codex host
tentaclaw-mcp codex-config install
tentaclaw-mcp codex-config checkThese commands preserve unrelated TOML and comments, reject conflicting TentaClaw entries, and validate the staged entry through installed Codex. RC13 accepts only a boolean enabled = true and a documented non-empty cwd on an otherwise exact entry. An exact RC6 entry is UPGRADE_REQUIRED; install migrates only the argument vector. Do not manually merge client-config codex, which is reference output only.
ChatGPT desktop through the local Codex host
Use the same guarded Codex configuration above when the desktop surface uses the local Codex host. Browser-only ChatGPT cannot launch a process on this computer and is outside the local-only architecture. This surface remains candidate/unaccepted pending the RC13 live and write-approval record.
Claude Desktop
tentaclaw-mcp client-config claude-desktopMerge the generated mcpServers.tentaclaw object into Claude Desktop’s config, preserving valid JSON and other servers. Completely quit and reopen Claude Desktop.
Claude Code
tentaclaw-mcp client-config claude-codeRun the one-line command it prints. Verify with claude mcp list and Claude Code’s /mcp command.
Gemini CLI 0.52.0
tentaclaw-mcp client-config gemini-cliThe integrity-locked 0.52.0 preflight and live read-only version/discovery/semantic checks pass. Full acceptance remains open until visible approval is recorded before every write tool. Gemini can show raw MCP arguments and results—including destination identifiers—in host-owned local tool panels; keep those panels local and share only sanitized evidence.
Perplexity for Mac local MCP
tentaclaw-mcp client-config perplexity-macInstall Perplexity’s supported local MCP helper, create a local connector, and paste the single generated command. If the exact Perplexity app/account does not show local MCP support, that product surface is not available for this test.
MCP Inspector
tentaclaw-mcp client-config inspectorRun the complete npx command it prints. Inspector starts TentaClaw as a local subprocess. Use it first when another client is difficult to diagnose.
Intentionally excluded templates
RC13 does not ship OpenClaw or Hermes templates because their current generic MCP paths do not provide the dependable per-call write-action approval gate required by this release. Do not translate another client template into an unsupported setup.
RC13 compatibility matrix
| Client target | Configuration | Current evidence |
|---|---|---|
| Codex CLI 0.145.0 / IDE | Guarded install/check/remove | Automated exact-host and native Windows gates pass; RC13 live/write approval pending |
| ChatGPT desktop / local Codex host | Same guarded Codex entry | Candidate/unaccepted |
| Claude Desktop / Code | Generated JSON / CLI command | Candidate/unaccepted |
| Gemini CLI 0.52.0 | Generated JSON | Read-only live acceptance passed; write approval pending |
| Perplexity Mac local MCP | Generated local command | Candidate/unaccepted |
| MCP Inspector | Generated diagnostic command | Automated stdio handshake passed; diagnostic target only |
| Gemini Spark | None | Unsupported: URL-only surface cannot launch local stdio |
| Generic Copilot MCP, Android Studio, Google Antigravity | None | Not release-qualified |
| OpenClaw / Hermes | Not shipped | Missing dependable per-call write approval |
Acceptance sequence for each client
- Record the exact client version and confirm local
stdiostartup. - Confirm exactly six tools and call
tentaclaw_version. - Call approved boards and chats; distinguish chat assistants from nested conversations.
- Require a visible approval step before
poppy_ask. - Require a new visible approval before
poppy_create_conversation. - Require a new visible approval before
poppy_chat. - Confirm denied cross-pair and fake destinations fail without spending credits.
- Keep raw host tool panels local and share only sanitized evidence.