# Working With AI Agents

Canonical page: https://docs.ovok.com/working-with-ai-agents

AI coding agents can help you explore Ovok, plan an integration, set up a project and implement application code. They work best when you give them the context of your application and ask them to verify platform behavior against the current Ovok documentation.

<Callout type="info" title="Runtime AI is a different topic">

Building AI *into* your application at runtime, such as clinical summarization or agents acting on patient data, is a different topic; see [Build with AI on Ovok](/settings-and-features/features/ai) for Ovok's documented `$ai` feature. This section is about using AI to *develop* on Ovok.

</Callout>

## Three pieces [#three-pieces]

| Piece | What it gives the agent | Page |
| --- | --- | --- |
| **Ovok skill** | Guidance: how to work on an Ovok app, what to verify, what to leave to a project admin. Not yet published for public install. | [Ovok skill](/working-with-ai-agents/ovok-skill) |
| **Ovok MCP server** | Access: named tools that read and set up one project, as the admin who connected it. | [Connect the MCP server](/working-with-ai-agents/mcp-server) · [MCP tools](/working-with-ai-agents/mcp-tools) |
| **AI-readable docs** | Context: Markdown for every page, a docs index, a page manifest and a full bundle. | [Docs for AI agents](/working-with-ai-agents/docs-for-agents) |

The docs work with any coding agent and need no Ovok access. The MCP server needs a project admin to approve it.

## Quick start [#quick-start]

1. Connect the MCP server for the sandbox, then authenticate it with `/mcp` in Claude Code:

   ```bash
   claude mcp add --transport http ovok https://api.sandbox.ovok.com/mcp
   ```

2. Ask for the work, with enough context. For example: “Read the project with the Ovok MCP tools, then read the Ovok docs for authentication and access policies, and plan a practitioner login for this app. Don't change settings yet.”

Then follow [Prompting and review](/working-with-ai-agents/prompting-and-review) to plan, build and check the result.
