Expand MCP Client guide: server removal, discovery walkthrough, and broader server examples #330
Description
Context
PR #277 review comments from @kovtcharov on docs/guides/mcp-client.mdx (lines 271-273, "Popular MCP Servers" / config section area) identified three improvements that should be addressed as a follow-up.
Requested Changes
1. Document MCP server removal (Ln 271)
"What about removing MCP server? How do you do that?"
AC:
- Add a section (or expand "Adding a New MCP Server") to cover removing a server
- Show the CLI command:
gaia mcp remove <name> - Show the programmatic approach:
agent.disconnect_mcp_server("<name>") - Mention that removal updates
mcp_servers.json
2. End-to-end walkthrough: search → integrate → query (Ln 271)
"this section can be expanded, include a walkthrough from searching for a specific mcp server to integrating it into gaia addressing the gap i mentioned above."
AC:
- Add a guided walkthrough that starts from browsing for a server (e.g. on glama.ai or the official MCP servers list)
- Walk through choosing a server, adding it to config, testing the connection, and querying the agent
- Should feel like a complete "first experience" flow — the user goes from zero to a working query
3. Expand Popular MCP Servers with more examples and a hub link (Ln 273)
"I think we can expand to more than just 3 mcp server. also include a web link to a source hub of mcp servers for users to integrate with."
AC:
- Expand the "Popular MCP Servers" tabs to include more than the current 3 (Filesystem, GitHub, Python Servers)
- Suggested additions: Memory, Brave Search, Postgres, Slack, or other high-value servers from the ecosystem
- Include a prominent link to an MCP server discovery hub (e.g. glama.ai/mcp/servers or the official servers repo)
References
- PR: MCP Client Support: Connect GAIA agents to any MCP server #277
- File:
docs/guides/mcp-client.mdx - Reviewer: @kovtcharov