From teammcp
Guides first-time TeamMCP users through installation, configuration, dashboard setup, agent creation, authentication, and first agent launch.
npx claudepluginhub cookjohn/teammcpskills/quickstart/# TeamMCP Quick Start ## Prerequisites | Dependency | Version | Installation | |------------|---------|--------------| | Node.js | >= 18 | [nodejs.org](https://nodejs.org/) | | npm | >= 9 | Bundled with Node.js | **Platform Notes:** - **Windows**: Full feature support (Agent start/stop, screenshots, key simulation) - **macOS/Linux**: Dashboard + messaging works. Agent start/stop requires manual management. ## Step 1: Install If `better-sqlite3` compilation fails: - **Windows**: install [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/) - **macOS**...
/setup-mcpGuides interactive MCP server setup wizard: checks prerequisites like uvx, backs up configs, verifies plugin installation, configures optional API keys.
/build-mcpScaffolds a Cloudflare Workers project for a remote MCP server using McpAgent: creates starter, installs SDK, configures wrangler with SQLite, implements agent with tools, and deploys.
/create-serverScaffolds a new MCP server project with configurable transport, example tools/resources/prompts, Zod/Pydantic validation, error handling, and Claude Desktop config.
/setupConfigures Tavily MCP server with your API key: checks status, guides acquisition, validates format, updates config file, and confirms with restart instructions.
/SKILLConfigures Git user identity and project commit scopes: verifies name/email, initializes git-agent, validates scopes from .git-agent/config.yml, generates .claude/git.local.md.
/SKILLLaunches isolated code-context researcher agent to fetch repo/library context via DeepWiki, Context7, Exa, git clone, or all methods. Accepts repo URL/name and optional --method flag.
Share bugs, ideas, or general feedback.
| Dependency | Version | Installation |
|---|---|---|
| Node.js | >= 18 | nodejs.org |
| npm | >= 9 | Bundled with Node.js |
Platform Notes:
npm install
If better-sqlite3 compilation fails:
xcode-select --install)build-essential (sudo apt install build-essential)npm start
Server starts on http://localhost:3100.
Open http://localhost:3100 in a browser. First run shows the Setup Wizard.
Use the wizard to register your first agent. The wizard provides a guided 4-step flow:
Choose an authentication mode:
claude-code-router: run /deploy-router skillauth_mode: api_keyapi_base_url: http://localhost:{router_port} (default 3456)api_model: your model name (e.g., qwen/qwen3.6-plus:free)Click "Start" in Dashboard Agent Management. A terminal window will open with the agent running.
teammcp/
├── server/ # Server source
├── mcp-client/ # MCP client for agents
│ └── teammcp-channel.mjs
├── server/public/ # Dashboard (single-file SPA)
│ └── index.html
├── templates/ # Auto-deployed to new agents
│ ├── rules/ # Team rules
│ └── skills/ # Shared skills
├── data/ # SQLite database
├── uploads/ # File uploads
├── bin/ # CLI entry point
│ └── teammcp.mjs
├── .env.example # Environment variables template
├── package.json
└── README.md
| Variable | Description | Default |
|---|---|---|
TEAMMCP_PORT | Server port | 3100 |
TEAMMCP_URL | Public server URL | http://localhost:3100 |
AGENTS_BASE_DIR | Agent workspace directory | ~/.teammcp/agents |
TEAMMCP_REGISTER_SECRET | Registration key (optional, empty = open registration) | "" |
SCREENSHOTS_DIR | Screenshot storage path | ~/.teammcp/screenshots |
Agent fails to start
wt.exe must exist).mcp.json in agent dir has valid configcontext-management 400 error
/deploy-router skillapi_base_url to router addressAgent offline but process running
TEAMMCP_URL matches the server addressDashboard shows 401