add-mcp-server

Configure global or project MCP servers in mcp.json for stdio or HTTP connections.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/v36372/pi-stuff --skill add-mcp-server-v36372
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-mcp-server
Source: https://github.com/v36372/pi-stuff/tree/main/skills/add-mcp-server
Command: npx skills add https://github.com/v36372/pi-stuff --skill add-mcp-server-v36372

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Add an MCP server configuration to pi-mcp-adapter by determining scope, server type, writing the config, and verifying the connection.

Core Features & Use Cases

  • Determine scope (Global or Project) and write the appropriate mcp.json.
  • Support MCP server types: stdio (local process) and HTTP (remote URL).
  • Verify the connection and provide a straightforward workflow for testing and troubleshooting.

Quick Start

Configure a new MCP server by choosing scope (global or project), selecting a type (stdio or HTTP), and saving the resulting config to the appropriate mcp.json.

Frequently Asked Questions about add-mcp-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add an MCP server configuration to mcp.json?▼

To add an MCP server, this skill determines your configuration scope (global or project), writes the updated mcpServers entry into the existing mcp.json, and verifies the connection using a reload workflow.

Can I configure both local and remote MCP servers?▼

Yes, you can configure both local and remote MCP servers. The skill supports stdio-based local servers for running local processes and HTTP-based remote servers for connecting to remote URLs within your mcp.json.

What is the difference between global and project-local MCP server configuration?▼

Global MCP server configuration applies across all projects, while project-local configuration is restricted to the current project. The skill determines the appropriate scope and writes the configuration to the corresponding mcp.json file.

How do I verify an MCP server connection after updating the config?▼

To verify an MCP server connection, the skill provides a verification workflow that uses the /reload command and mcp calls to test and troubleshoot the newly registered server connection.

Will configuring a new MCP server overwrite my existing mcp.json settings?▼

Configuring a new MCP server will not overwrite existing settings. The skill reads and merges your current mcp.json content, writes the updated mcpServers entry, and preserves your prior configurations.