Skip to main content

Quickstart: MCP (AI Agents)

Connect your AI coding agent to appgrammar in 3 steps.

1. Get an MCP Token​

Sign in at appgrammar.com and go to MCP Setup in the sidebar. Generate a new token and copy it.

2. Configure Your Agent​

Add appgrammar to your agent's MCP configuration:

Claude Code​

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "appgrammar": {
      "url": "https://appgrammar.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

Cursor​

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "appgrammar": {
      "url": "https://appgrammar.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

3. Create and Execute Your First Appgrammar​

Tell your agent:

Create an appgrammar for a task management API with TypeScript and PostgreSQL, then execute it.

Your agent will:

  1. Call appgrammar_create to generate a 5-step plan
  2. Submit each step result via appgrammar_create_submit
  3. Once ready, call appgrammar_start to get the first execution step
  4. Work through each step via appgrammar_next until dn: true

What Happens During Creation​

The 5-step creation pipeline generates:

StepOutput
1. ArchitectureModule graph, dependencies, technology choices
2. Design SystemUI framework, colors, typography, component patterns
3. Task DAGOrdered build steps with parallel groups
4. File RegistryEvery file path with exports and dependencies
5. EnrichmentCompressed specifications for each step

What Happens During Execution​

Each call to appgrammar_next returns a stage containing one or more parallel groups. Groups within a stage can run concurrently. Steps within a group run sequentially.

Stage 0: [Group A: step 1, step 2] [Group B: step 1]
Stage 1: [Group C: step 1, step 2, step 3]
Stage 2: [Group D: step 1]

Each step includes:

  • File paths to create or modify
  • Compressed specification describing the implementation
  • Context from previous steps
  • Registry of all project files

Team Connections (Optional)​

If you're part of a team, you can add a team-scoped connection so your team's conventions are automatically applied to every appgrammar you build:

Claude Code​

claude mcp add --transport http appgrammar-myteam https://appgrammar.com/mcp \
  --header "Authorization: Bearer YOUR_MCP_TOKEN" \
  --header "X-Team-Id: YOUR_TEAM_UUID"

Cursor / VS Code​

Add "X-Team-Id": "YOUR_TEAM_UUID" to the headers object and change the key from appgrammar to appgrammar-myteam.

The MCP Setup page generates these snippets for you -- just select your team in the team scope selector.

See MCP Token Management for all IDE configurations.

Next Steps​