> Meticulous records real user sessions from a web app and replays them against each commit to catch visual regressions.
>
> Full AI-readable docs index (complete project setup journey + every page as markdown): https://app.meticulous.ai/llms.txt

# Setting up Meticulous for agents

Meticulous exposes the same read, analysis, and test-run-triggering operations to agents in a few different ways — pick whichever fits how your agent connects.

- [CLI](#cli) — a global `meticulous` binary the agent runs in your terminal.
- [MCP](#mcp) — the hosted MCP server, for agents that speak MCP.
- [Skills](#skills) — pre-defined workflows on top of any of the above.
- [Ready to use integrations](#ready-to-use-integrations) — one-click installs for Claude Code and Cursor.
- [Org-wide setup](#org-wide-setup) — connect Meticulous for your whole team at once, via an OAuth-based connector or a centrally-managed project token.

---

## CLI

To set up the Meticulous CLI:

```bash
npm install --global @alwaysmeticulous/cli@latest
meticulous auth login
```

See [CLI commands](/docs/agents/cli-commands) for more details, including more authentication options and the command reference.

---

## MCP

**Claude Code**

Run the following in your terminal:

```bash
claude mcp add --transport http Meticulous https://app.meticulous.ai/api/mcp
```

Then, in Claude Code, type `/mcp` and choose "Authenticate" for the Meticulous MCP.

**Cursor**

Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per project):

```json
{
  "mcpServers": {
    "Meticulous": { "url": "https://app.meticulous.ai/api/mcp" }
  }
}
```

**Codex/ChatGPT**

Add a server with name "Meticulous" and URL `https://app.meticulous.ai/api/mcp`, then click "Authenticate".

See [MCP server](/docs/agents/mcp-server) for more details, including the full list of available tools.

---

## Skills

To install, and update, the skills into your project using [npx skills](https://github.com/vercel-labs/skills) (for the specified agents):

```bash
npx skills add alwaysmeticulous/skills --skill "*" --agent claude-code --agent codex --agent cursor -y
```

See [Skills & Use cases](/docs/agents/skills) for what skills are, the full list of them, and what each one is for.

---

## Ready to use integrations

**Claude Code MCP**

Install the hosted MCP server directly from the [Claude directory](https://claude.ai/directory/meticulous).

**Claude Code plugin**

For Claude Code, the skills and the MCP server come packaged together as a [plugin](https://code.claude.com/docs/en/discover-plugins), covering both of those steps in one go. It installs all the skills, namespaced as `/meticulous:<skill-name>`, and connects the hosted MCP server for you. Run in Claude Code:

```shell
/plugin marketplace add alwaysmeticulous/skills  # register the repo as a plugin marketplace
/plugin install meticulous@meticulous            # install the Meticulous plugin from it
```

Then type `/mcp` and choose "Authenticate" for the Meticulous MCP server.

**Cursor plugin**

Install the MCP server and skills directly from the [Cursor marketplace](https://cursor.com/marketplace/meticulous).

---

## Org-wide setup

The steps above set up Meticulous for a single user. To roll it out to your whole team, there are two approaches:

- **OAuth-based connectors** authenticate each user individually — an org admin adds a shared connector once, then every team member still authenticates via OAuth themselves the first time they use it, to activate their own access.
- **A project API token** authenticates everyone centrally — configured once by an admin, with no individual OAuth step. This is also the option for agent platforms that take a fixed credential instead of a CLI or MCP client (e.g. Claude Tag).

To set up an org-wide MCP connector, navigate to:

- **Claude Code:** Organization Settings > Connectors > Add (Web).
- **Cursor:** Settings > Integrations & MCP > Team MCP Servers > Add (Remote HTTPS).

To configure it with a project API token, so it authenticates every user centrally, do the following:

- **URL:** `https://app.meticulous.ai/api/mcp`
- **Credential type:** Bearer
- **Prefix:** `Bearer`
- **Value:** a project API token

Select the project below, then copy the token (careful: grants access to recorded sessions!):

```
<API_TOKEN>
```

As a concrete example of the general steps above, for Claude Tag (Claude in Slack):

1. Go to [claude.ai/admin-settings/claude-tag/access-bundles](https://claude.ai/admin-settings/claude-tag/access-bundles).
2. Under **General > Credentials**, click **Connect**.
3. Set Name to `Meticulous` and Credential type to `Bearer`.
4. Set Allowed websites to `app.meticulous.ai`.
5. Under **Custom headers**, click **Add header**, and set:
   - Name: `Authorization`
   - Prefix: `Bearer`
   - Value: the project API token created above.

---

*There is also an [agent-addressed version of this page](/docs/agents/setup-for-agents), written for the agent rather than for you. That's what we point agents at in various places like CI comments, so they can get set up without you having to explain any of the above — feel free to hand your agent the link directly.*