Skip to main content
The Coval connector lets an AI assistant work with the same Coval organization you use in the web app. You can inspect evaluation data, create supported resources, launch runs, and ask Sofia for evaluation guidance without switching workflows.

​
Common Workflows

​
Build test sets

Ask: “Create a test set for a billing support agent with refund, cancellation, and payment-failure scenarios.” The assistant can create the test set and add individual test cases through separate write tools.

​
Launch and monitor evaluations

Ask: “Run the billing test set against my support agent, then tell me the new run ID.” The assistant resolves the named resources before creating the run.

​
Inspect results

Ask: “Which of my recent evaluations were unsuccessful?” The assistant reads your run data and summarizes the result without changing anything.

​
Consult Sofia

Ask: “Have Sofia inspect my latest failed run and recommend what I should test next.” Sofia combines your organization’s evaluation evidence with Coval product and voice-agent evaluation knowledge. This consultation is read-only.

​
Connect

  1. Install Coval from the ChatGPT or Claude directory, or add https://mcp.coval.dev/mcp to Codex or another MCP client.
  2. Sign in to Coval in the browser window that opens.
  3. Select the organization you want the assistant to access.
  4. Approve access and return to your client.
  5. Start with: “List my Coval agents and three most recent runs.”
For direct directory links and exact client-specific steps, see Installation.

​
Working Safely

  • Name the exact resource when requesting a write or update.
  • Review the assistant’s proposed inputs before approving costly work such as a run.
  • Use disposable names while testing the connector.
  • consult_sofia can analyze and recommend, but it cannot mutate your organization.
  • Disconnect and reconnect when you need to switch organizations.