Skip to content
Componecat Docs

Connect AI agents

Componecat exists to give AI coding agents the context they’re usually missing: which components exist, how they fit together, who owns them, and how to reach them. It exposes the whole catalog over a Model Context Protocol (MCP) server, so an agent can query the catalog directly, in real time, before it writes code.

The MCP endpoint

Section titled “The MCP endpoint”

The MCP server is served at /api/mcp. For the hosted app that’s:

https://app.componecat.ai/api/mcp

Add it to any MCP-capable client (Claude, an IDE agent, or your own) as a remote MCP server. Because catalogs are private and organization-scoped, the endpoint requires authentication.

Authorizing an agent

Section titled “Authorizing an agent”

Componecat supports the standard MCP authorization flow:

  • OAuth device flow — the usual path for interactive agents. The client discovers the authorization server automatically, you approve the request in the browser, and the agent receives a token. The approval screen names the client that is asking, so you can tell what you are authorizing before you grant it. Dynamic client registration is supported, so most clients need no manual setup.
  • Personal access tokens — a bearer token you create yourself, useful for scripts and non-interactive clients. Create one from your access-token settings.

Tokens are scoped. You grant an agent read or write access per resource category — catalog entities, teams, schema — and can even scope a token to specific entities. Grant the narrowest access that does the job; a read-only token is enough for an agent that only needs context.

What an agent can do

Section titled “What an agent can do”

Once connected, an agent has tools to:

  • Search and browse the catalog — find entities, list them by kind or owner, and read a single entity’s full detail.
  • Traverse relationships — follow dependencies and run impact analysis to see what a change affects.
  • Read documentation — retrieve an entity’s Markdown sections and its activity log to answer questions with organizational grounding.
  • Inspect interfaces — read API specs, package coordinates, and other connectivity details to generate clients or integration tests.
  • Make changes — with write access, create and update entities, relationships, interfaces, and documentation.
  • Read Componecat’s own documentation — list and read these pages to learn how the platform works, so the agent can walk you through setting up an integration or writing a descriptor file instead of guessing at it.

An agent can also browse the catalog as MCP resources: each entity is readable as its componecat.yaml descriptor, and a kind’s entities can be listed without knowing your taxonomy in advance.

Typical workflows

Section titled “Typical workflows”
  • Grounded code generation — before generating code for a service, the agent looks up its kind, languages, interfaces, and conventions.
  • Cross-service integration — the agent follows depends-on edges, reads the target’s interface spec, and writes a correct client.
  • Ownership resolution — the agent finds the owning team to route a review or an escalation.
  • Documentation-grounded answers — the agent retrieves runbooks and architecture notes to answer a developer’s question with your context, not generic guesswork.
  • Guided setup — the agent reads Componecat’s own documentation to talk you through connecting a provider or cataloguing a repository, step by step.
Section titled “Related”