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 — a global meticulous binary the agent runs in your terminal.
• MCP — the hosted MCP server, for agents that speak MCP.
• Skills — pre-defined workflows on top of any of the above.
• Ready to use integrations — one-click installs for Claude Code and Cursor.
• Org-wide setup — connect Meticulous for your whole team at once, via an OAuth-based connector or a centrally-managed project token.

To set up the Meticulous CLI:

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

See CLI commands for more details, including more authentication options and the command reference.

Claude Code

Run the following in your terminal:

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):

{
  "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 for more details, including the full list of available tools.

To install, and update, the skills into your project using npx skills (for the specified agents):

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

See Skills & Use cases for what skills are, the full list of them, and what each one is for.

Claude Code MCP

Install the hosted MCP server directly from the Claude directory.

Claude Code plugin

For Claude Code, the skills and the MCP server come packaged together as a plugin, 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:

/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.

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.
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.