skills.rest
Chia1104
Chia1104COMMUNITY
Explore all skills by this author →
Website𝕏@chia7423GitHub

mcp-server-setup

Configure and troubleshoot MCP servers in Hermes Agent config.yaml via CLI commands.

1|Updated Aug 11, 2026
Search Tags:#troubleshooting#oauth#cli#MCP#configuration#figma#hermes
One-click install
npx skills add https://github.com/Chia1104/agent-air --skill mcp-server-setup-chia1104
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mcp-server-setup
Source: https://github.com/Chia1104/agent-air/tree/main/skills/hermes/autonomous-ai-agents/mcp-server-setup
Command: npx skills add https://github.com/Chia1104/agent-air --skill mcp-server-setup-chia1104

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Adding MCP servers to Hermes Agent fails when users edit config.yaml directly (blocked by a security guard) or when SaaS-hosted remote MCP servers reject OAuth client registration with allowlist-gated 403 errors, leaving users without a clear path to a working integration. ## Core Features & Use Cases - CLI-driven server setup: Add stdio (npx/uvx) or remote HTTP MCP servers using hermes mcp add, with guidance for handling interactive OAuth prompts in non-interactive terminals. - OAuth troubleshooting ladder: Diagnose Registration failed: 403 errors from providers like Figma that allowlist dynamic client registration, with ordered workarounds including client_name overrides, pre-registered client_id, and local desktop MCP variants. - Verification workflow: Confirm servers work using hermes mcp list, hermes mcp test, and /reload-mcp after configuration changes. - Use Case: You try to connect Figma's remote MCP server and hit a 403 during OAuth registration. This Skill walks you through confirming the failure is provider-side, then sets up Figma Desktop's local MCP server at http://127.0.0.1:3845/mcp as the working alternative. ## Quick Start Ask the agent to add a new MCP server to Hermes and verify it connects, or to diagnose why an OAuth-based MCP server login is failing.

Frequently Asked Questions about mcp-server-setup

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

FAQPage Schema
How do I add an MCP server to Hermes Agent?▼

Add MCP servers with the hermes CLI: `hermes mcp add <name> --command npx --args -y pkg-name` for stdio servers, or `hermes mcp add <name> --url <url>` for HTTP servers. Direct edits to ~/.hermes/config.yaml are blocked by a security guard.

Why does MCP OAuth registration fail with 403 Forbidden?▼

A `Registration failed: 403` error means the provider's authorization server rejected dynamic client registration because your client is not on its allowlist. This is provider policy, not a Hermes bug, and occurs before any authorization URL is generated.

Can I connect Figma's remote MCP server from Hermes?▼

Figma's remote MCP server allowlists client_name during registration and rejects Hermes with 403, even with a client_name override. The working alternative is Figma Desktop's local MCP server at http://127.0.0.1:3845/mcp, which needs no OAuth.

How do I verify an MCP server is working in Hermes?▼

Run `hermes mcp list` to see transport and tool counts, and `hermes mcp test <name>` for a live connection attempt with real error messages. Use `/reload-mcp` or start a fresh session to apply config changes, since discovery runs at startup.

Why does hermes mcp add --auth oauth hang in a script?▼

The OAuth flow is interactive and prompts for confirmation, so it hangs in non-interactive terminals. Run it with pty=true, pipe answers via stdin, or save a disabled entry and complete OAuth later with `hermes mcp login <name>`.

Related Skills

Explore More Software Engineering Skills→
rnbenrnben

native-mcp

Connect Hermes Agent to MCP servers and register discovered tools.

Community
Advanced
PrismaibrowserPrismaibrowser

agentmemory-agents

Configures host coding agents to connect to the agentmemory server via MCP or native hooks.

Official
Intermediate
afel6afel6

native-mcp

Connect to MCP servers and expose their tools as native Hermes Agent tools.

Community
Advanced
overlensoverlens

idp-register-oauth-client

Registers OAuth clients in the Overlens IDP via the POST /admin/clients admin API.

Official
Intermediate