VS Code Integration — Setup

Use the AI Passport VS Code extension (recommended) or configure MCP manually.

---

Option A — Extension (recommended)

Install CLI

npm install -g @ai-passport-core/cli

Install extension

1. Open VS Code → Extensions
2. Search AI Passport (or install from .vsix after npm run compile in extensions/vscode/)
3. Open a workspace folder
4. Command Palette → AI Passport: Setup Workspace

This runs ai-passport onboard vscode, writes .vscode/mcp.json, and grants the vscode consumer.

Command	Purpose
AI Passport: Setup Workspace	Full first-time setup
AI Passport: Configure MCP	Write/merge .vscode/mcp.json only
AI Passport: Show Status	Readiness + next steps
AI Passport: Open MCP Config	Open workspace MCP file

Settings: aiPassport.cliPath, aiPassport.consumer (default vscode).

Extension source: extensions/vscode/

Marketplace publish guide: VSCODE_MARKETPLACE.md

---

Option B — Manual MCP configuration

Any MCP-compatible VS Code extension can consume AI Passport the same way as Cursor.

---

Prerequisites

• Node.js 20+
• VS Code with an MCP-capable AI extension (e.g. Copilot Chat + MCP support, or compatible fork)
• AI Passport CLI:

npm install -g @ai-passport-core/cli

---

Step 1 — Onboard

ai-passport onboard vscode --yes

Optional git enrichment:

ai-passport onboard vscode --path . --yes

This grants the vscode consumer (sections: coding, projects per grant-templates.json).

---

Step 2 — MCP configuration

Add to your VS Code MCP settings — workspace file .vscode/mcp.json (VS Code 1.96+):

{
  "servers": {
    "ai-passport": {
      "type": "stdio",
      "command": "ai-passport",
      "args": ["mcp", "serve", "--consumer", "vscode"]
    }
  }
}

Legacy Cursor-style config (not used by VS Code Copilot MCP):

{
  "mcpServers": {
    "ai-passport": {
      "command": "ai-passport",
      "args": ["mcp", "serve", "--consumer", "vscode"]
    }
  }
}

Local development:

{
  "mcpServers": {
    "ai-passport": {
      "command": "node",
      "args": ["C:\\path\\to\\ai-passport\\dist\\index.js", "mcp", "serve", "--consumer", "vscode"]
    }
  }
}

See examples/mcp.vscode.json.

---

Step 3 — Verify

CLI readiness (JSON for scripts / extension):

ai-passport readiness --consumer vscode --json

Tool	Purpose
get_passport_status	Readiness + next steps
get_passport_context	Filtered export (audited)
get_active_project	Active project peek
list_grants	Grant summary

Ask your AI assistant: “What stack am I working with?”

---

Troubleshooting

Problem	Fix
No grant for vscode	ai-passport grant vscode --yes
Passport missing	ai-passport init or ai-passport onboard vscode --yes
Wrong sections	Revoke and re-grant: ai-passport revoke vscode then grant again

---

Cursor vs VS Code

	Cursor	VS Code
Consumer id	cursor	vscode
Default sections	identity, coding, projects	coding, projects
MCP command	Same ai-passport mcp serve	Same

Core and MCP server are shared — only the consumer id and grant scope differ.