# maxxing-mcp

maxxing-mcp is a Claude Code skill that manages MCP servers in Harness Maxxing. It activates for server setup, connection checks, OAuth sign-in, and troubleshooting.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 285 repo stars
- Author: makushingu
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/makushingu/harness-maxxing/tree/HEAD/skills/maxxing-mcp/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/maxxing-mcp

## What it does

The skill uses `maxxing mcp` to add a server from a URL or command, inspect its status, or remove it. A server can be assigned to a project topic or made available across sessions. The server list and controls are in `Settings -> MCP`.

For OAuth, the user completes sign-in in a browser from `Settings -> MCP -> Connect`. Secrets belong in the vault, not in plain-text configuration; reference them with variables such as `${NAME}`. A newly added server becomes available on the next turn. Install with `npx skills add makushingu/harness-maxxing --skill maxxing-mcp -a claude-code`.

## Requirements
- Works with: Notion

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill maxxing-mcp -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/maxxing-mcp/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/maxxing-mcp/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill maxxing-mcp -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/maxxing-mcp/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill maxxing-mcp -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/maxxing-mcp/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install makushingu/harness-maxxing skills/maxxing-mcp
```

2. **Manually: put the files in place**
- File: `.github/skills/maxxing-mcp/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill maxxing-mcp -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/makushingu/harness-maxxing --path skills/maxxing-mcp
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/maxxing-mcp/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/makushingu/harness-maxxing/tree/HEAD/skills/maxxing-mcp/SKILL.md

## When to use it
- add an MCP server from a URL or command
- assign a server to a project topic or all sessions
- check server status and diagnose connection errors
- remove a server or complete OAuth sign-in

## Example prompts
- Add the Google Ads MCP server for the `ads` topic at `https://mcp.example.com/mcp`.
- Check the MCP server statuses and explain why one server is disconnected.
- Remove the `notion` server and show how to authorize a new MCP server.

## Similar
- [lead-magnets](https://affpapa.org/en/nevibecode/skills/lead-magnets.md) — skill · 125000 installs
- [notion-api](https://affpapa.org/en/nevibecode/skills/notion-api.md) — skill · 106200 installs
- [composio](https://affpapa.org/en/nevibecode/skills/composio.md) — skill · 9200 installs
- [data-scraper-agent](https://affpapa.org/en/nevibecode/skills/data-scraper-agent.md) — skill · 6300 installs
- [notion](https://affpapa.org/en/nevibecode/skills/notion.md) — skill · 5700 installs
- [notion-automation](https://affpapa.org/en/nevibecode/skills/notion-automation.md) — skill · 5000 installs

From the same set: [makushingu/harness-maxxing](https://affpapa.org/en/nevibecode/by/makushingu/harness-maxxing.md) — 21 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
