evolution-foundation Dev MCP Setup
Derived from oh-my-claudecode (MIT, Yeachan Heo). Adapted for the EvoNexus Engineering Layer.
Configure MCP (Model Context Protocol) servers for the workspace. When a new integration needs access at the MCP layer (rather than via skill-level API calls), this skill walks through the configuration.
Use When
- Adding a new MCP-backed integration (web search, GitHub, Notion, etc.)
- Diagnosing why an existing MCP server isn't responding
- Setting up a fresh EvoNexus workspace with all standard MCPs
Do Not Use When
- The integration is API-based (use the appropriate
int-*skill instead) - You just need to invoke an existing MCP tool (just use it)
EvoNexus Standard MCPs
These are typically configured in ~/.claude/settings.json or .claude/settings.json:
| MCP | Purpose | Setup |
|---|---|---|
| google-calendar | Calendar events | OAuth |
| gmail | Email read/send | OAuth |
| linear-server | Linear issues/projects | API key |
| github | GitHub PRs/issues/files | GitHub token |
| canva | Design files | OAuth |
| claude_ai_Notion | Notion pages | OAuth |
| computer-use | Desktop control | local |
| figma | Design files | OAuth |
| plugin_telegram | Telegram bot | bot token |
Workflow
- Identify which MCP server you need to add
- Check current config — read
.claude/settings.json(project) or~/.claude/settings.json(user) - Add the server entry with its required env vars or auth
- Restart Claude Code to load the new MCP
- Verify by listing tools — the new MCP's tools should appear with
mcp__<server>__*prefix - Document the addition in
workspace/development/research/[C]mcp-setup-{server}-{date}.md
Configuration Example
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "${GITHUB_TOKEN}"
}
}
}
}
Diagnostics
If an MCP isn't working:
- Check Claude Code logs for spawn errors
- Verify env vars are set
- Test the MCP server independently if possible
- Check that the MCP package is installed
Pairs With
update-config(built-in skill for settings.json edits)@scout-explorer(to find existing MCP configurations)