What you need before the first run
Available now These requirements apply to the released MCP server.
The first workflow requires Node.js 22 or newer. It also requires an MCP host and one authenticated backend.
The first-use workflow uses Codex. Before you run that workflow, authenticate Codex.
Get the Node.js version
Section titled “Get the Node.js version”Run this command:
Runtime version check · shell command
node --versionThe result must show Node.js 22 or newer.
If the command fails, install a current Node.js release. Then run the command again.
Read the MCP host requirements
Section titled “Read the MCP host requirements”Use an MCP host that supports local stdio servers and MCP tools. MCP prompt support is optional.
The host must let you configure a command and an argument list. The host must also show tool results.
Refer to the Model Context Protocol documentation for protocol information. Refer to your host documentation for its settings location.
Authenticate Codex
Section titled “Authenticate Codex”Run this command:
Codex authentication · shell command
codex loginComplete the login process. The Codex credential remains in the Codex credential store.
AgentPrism does not receive a credential through the MCP request.
Other supported backends
Section titled “Other supported backends”Authenticate only the backends that your workflow calls.
| Backend | Included path | Authentication source |
|---|---|---|
| Claude | Bundled ACP backend | claude /login, ~/.claude/.credentials.json, or ANTHROPIC_API_KEY |
| Codex | Bundled ACP backend | codex login or ~/.codex/auth.json |
| pi | Bundled ACP backend | A provider API key or ~/.pi/agent/auth.json |
| OpenCode | Not bundled | opencode auth login |
AgentPrism supports OpenCode, but does not bundle it. Before a workflow calls the opencode backend, install its CLI.
Prepare the working directory
Section titled “Prepare the working directory”Open the project that you want the workflow to inspect. Start the MCP host from the applicable project context.
Agent calls can use tools in that project. Before you run a workflow script, review it.