Claude Code
-
Add the server:
Terminal
-
Start Claude Code and run
/mcp. Select veryfront, authenticate, then sign in to Veryfront and select Approve. Check the app name, signed-in account, and return host before approving. -
Ask: Use Veryfront to list my projects. The client calls
veryfront__list_projectsand returns the projects you can access.
Codex
-
Add the server:
Terminal
-
Authenticate, then sign in to Veryfront and select Approve:
Terminal
-
Open Codex and ask: Use Veryfront to list my projects. Use
/mcpto inspect the connection and available tools.
Cursor
-
Add the server to your project’s
.cursor/mcp.json, or merge this entry into an existingmcpServersobject:.cursor/mcp.json - In Cursor’s MCP settings, authenticate veryfront. Sign in to Veryfront and select Approve.
- In Agent chat, ask: Use Veryfront to list my projects. Approve the tool call when Cursor prompts you.
Check access
The clean/mcp URL lists canonical names such as veryfront__list_projects. No naming query parameter is required. An empty project list is valid if your account has no projects.
The connection uses your existing Veryfront permissions, including authorized writes. OAuth does not grant access to another user’s resources or connect external services for you. Connect an integration before calling tools that need an external account.
For a project connection, use https://api.veryfront.com/projects/{project_reference}/mcp, replacing {project_reference} with the project UUID or URL-encoded slug. The endpoint resolves that project and checks your access.
If authentication fails, check the server URL and sign in again. If a tool call fails, inspect its permissions and arguments in the MCP reference.
Revoke access
In Veryfront, open Settings → Authorized apps. Select Revoke beside the client and confirm. The client’s next MCP request fails; connect and approve again to restore access. Removing a server from a client’s local configuration does not revoke its Veryfront grant. Revoke the grant in Veryfront when you stop using a client.Alternative: API key
For CI or headless clients, create an API key and use the same server URL with the headerAuthorization: Bearer <API_KEY>. Existing API-key connections remain supported.
For Codex, read the key from an environment variable set by your secret manager:
Terminal
opencode.json:
opencode.json
opencode mcp list to inspect the connection.
For other clients, configure the Authorization header through their supported secret settings. Keep API keys out of shared configuration files and source control. API-key access is managed through the key’s permissions and lifecycle, separately from Authorized apps.
Debug a run
In Studio, open a failed agent run and select Copy debugging prompt. Paste the prompt into your connected coding agent. The prompt names the project and the run, and asks the agent to:- Read the run with
get_agent_run. - Read its events with
get_agent_run_events. - Read its child runs with
list_child_agent_runs_by_parent_run. - Explain what failed and propose a fix, for example with
update_agent.
Related
- Tool names and compatibility: Preserve an existing client’s discovery names.
- List projects: Inspect the first read-only tool call.