Documentation

Getting Started with TeamContext

Everything you need to set up TeamContext for your engineering team in under 2 minutes.

Overview

TeamContext is a team visibility platform for AI-assisted development. It integrates with any MCP-compatible AI coding tool — Claude, Codex, Gemini, and more — to automatically capture, summarize, and share the context from your team's coding sessions.

With TeamContext, every team member can see what others are building, what decisions were made, and where potential conflicts exist — all without disrupting anyone's workflow.

Installation

TeamContext installs as an MCP server for your AI coding tool. Run the following command in your terminal:

                            npx @teamcontext/mcp-server init
                        

This command will:

Install the TeamContext MCP server
Add it to your MCP configuration
Authenticate with your TeamContext account

Configuration

After installation, your MCP configuration file will include the TeamContext server. For example, in Claude Code (~/.claude/mcp.json):

{
  "mcpServers": {
    "teamcontext": {
      "command": "npx",
      "args": ["@teamcontext/mcp-server"],
      "env": {
        "TC_API_KEY": "your-api-key"
      }
    }
  }
}

You can find your API key in the TeamContext dashboard under Settings → API Keys.

Your First Session

Once installed, simply use your AI coding tool as you normally would. TeamContext runs in the background and automatically:

Captures session context (file changes, decisions, discussions)
Generates AI summaries of what was accomplished
Syncs context to your team dashboard

Open your TeamContext dashboard to verify events are flowing. You should see your session appear within seconds.

Using the Dashboard

The TeamContext dashboard gives you a real-time view of your team's AI-assisted development activity:

Activity Feed — Live stream of team events
Projects — Grouped view by repository/project
Decisions — Searchable log of all technical decisions
Conflicts — Alerts for overlapping work
Handoffs — Generate context packages for team transitions

Team Setup

To add team members, go to Settings → Team in your dashboard and invite them via email. Each member will need to run the MCP server installation command on their machine.

Once all members have connected, you'll see their activity in the shared dashboard. Conflict detection and smart handoffs activate automatically when 2+ members are active on the same project.

Need help?

Join our Discord community for real-time support, or email us at support@teamcontext.dev.