Back to Examples

Claude Code Project Setup (.mcp.json + CLAUDE.md)

Share MCP servers and project rules with your whole team via two checked-in files.

Agent Setup•Beginner•json
Example Code
// .mcp.json — project-scoped MCP servers, checked into git.
// Every teammate running Claude Code in this repo gets them automatically.
{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    },
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}

// CLAUDE.md — one line, so Claude Code and every
// AGENTS.md-reading agent share the same project rules:
//
//   @AGENTS.md

When to use this

Share MCP servers and project rules with your whole team via two checked-in files.

Quick Info
Difficulty: Beginner
Language: json
Copy the block above and adapt it to your project.