Run any Skill in Manus with one click

mcp-server-management

Use when admin asks to configure an MCP tool server (e.g., GitHub, weather API), rotate credentials, grant/revoke worker access to MCP tools, or add a custom API integration via YAML.

Run Skill in Manus

Stars4,767

Forks573

UpdatedMarch 29, 2026 at 03:45

Source

agentscope-ai

agentscope-ai/HiClaw

View GitHub Repository View Creator Repositories

Install command

Download

Run Skill in Manus

Useful forSOC

Software DevelopersComputer and Mathematical Occupations15-1252L4

File Explorer

8 files

SKILL.md

readonly

name	mcp-server-management
description	Use when admin asks to configure an MCP tool server (e.g., GitHub, weather API), rotate credentials, grant/revoke worker access to MCP tools, or add a custom API integration via YAML.

MCP Server Management

MCP Servers expose REST APIs as tools on the Higress AI Gateway, or proxy existing MCP servers (SSE/StreamableHTTP). Use setup-mcp-server.sh to create/update from YAML templates, or setup-mcp-proxy.sh to proxy existing MCP servers. Built-in templates are at references/mcp-*.yaml.

Gotchas

Cloud mode (HICLAW_RUNTIME=aliyun) does not support script-based MCP management — direct admin to the Alibaba Cloud AI Gateway console instead
Auth plugin takes ~10s to activate after server creation/update — always wait and verify with mcporter before notifying Workers
Always verify end-to-end before notifying Workers — call at least one tool via mcporter to confirm connectivity. Do not push broken tools
Never echo credentials in chat messages — credentials are stored only in Higress config, Workers access via gateway proxy
Consumer authorization is a REPLACE operation — when calling the API manually, include ALL consumers (manager + all workers), not just the new one
All YAML configs must use accessToken: "" as the credential key — the setup script substitutes the real value
Only notify relevant Workers — do not broadcast to all Workers, only those whose role/task needs the new tool
MCP Server SSE endpoint always returns 200 — auth is checked on POST /mcp/<name>/message, not on SSE connect
mcp-proxy only supports http and sse transport — stdio servers cannot be proxied through the gateway

Operation Reference

Read the relevant doc before executing. Do not load all of them.

Situation	Read
Create/update an MCP server or rotate credentials	`references/create-update-server.md`
Generate YAML for a custom API integration	`references/custom-yaml-guide.md`
List, inspect, delete servers, or manage consumer access manually	`references/api-commands.md`
Proxy an existing MCP server (SSE/HTTP)	`references/setup-mcp-proxy.md`
Need the GitHub MCP tool definitions	`references/mcp-github.yaml`

More from this repository

same repository

file-sharing

agentscope-ai/HiClaw

Use before direct filesync calls, reading non-task shared files, pushing mid-task progress, or troubleshooting missing shared files. Do not use for normal task acceptance or submission; taskflow ack_task and submit_task handle lifecycle sync internally.

2026-06-074.8k

file-sharing

agentscope-ai/HiClaw

Use before filesync calls for project directories, global-shared inputs, non-task shared files, listing shared paths, or troubleshooting missing files. Do not use for task-level sync; taskflow delegate_task and check_task handle task directory sync internally.

2026-06-074.8k

file-sync

agentscope-ai/HiClaw

Sync files with centralized storage. Use when your coordinator or another Worker notifies you of file updates (config changes, task files, shared data, collaboration artifacts).

2026-06-024.8k

find-skills

agentscope-ai/HiClaw

Discover and install agent skills from the open ecosystem. Use when you encounter an unfamiliar domain, framework, or workflow that you lack specialized knowledge about, or when your coordinator suggests searching for skills before starting a task.

2026-06-024.8k

mcporter

agentscope-ai/HiClaw

Discover and call MCP Server tools via the mcporter CLI. Use when your coordinator notifies you about new MCP tools, or when you need to call external APIs. Includes workflow for generating skill documentation for new MCP servers.

2026-06-024.8k

project-participation

agentscope-ai/HiClaw

Use when you are invited to a Project Room or assigned a task within a multi-worker project. Covers project plan reading, task coordination with other Workers, and git author config.

2026-06-024.8k

MCP Server Management

Gotchas

Cloud mode (HICLAW_RUNTIME=aliyun) does not support script-based MCP management — direct admin to the Alibaba Cloud AI Gateway console instead

Auth plugin takes ~10s to activate after server creation/update — always wait and verify with mcporter before notifying Workers

Always verify end-to-end before notifying Workers — call at least one tool via mcporter to confirm connectivity. Do not push broken tools

Never echo credentials in chat messages — credentials are stored only in Higress config, Workers access via gateway proxy

Consumer authorization is a REPLACE operation — when calling the API manually, include ALL consumers (manager + all workers), not just the new one

All YAML configs must use accessToken: "" as the credential key — the setup script substitutes the real value

Only notify relevant Workers — do not broadcast to all Workers, only those whose role/task needs the new tool

MCP Server SSE endpoint always returns 200 — auth is checked on POST /mcp/<name>/message, not on SSE connect

mcp-proxy only supports http and sse transport — stdio servers cannot be proxied through the gateway

Operation Reference

Read the relevant doc before executing. Do not load all of them.

Situation

Read

Create/update an MCP server or rotate credentials

references/create-update-server.md

Generate YAML for a custom API integration

references/custom-yaml-guide.md

List, inspect, delete servers, or manage consumer access manually

references/api-commands.md

Proxy an existing MCP server (SSE/HTTP)

references/setup-mcp-proxy.md

Need the GitHub MCP tool definitions

references/mcp-github.yaml