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.