ha-inlite

Home Assistant integration for in-lite
git clone https://git.stephank.nl/ha-inlite
Log | Files | Refs | README | LICENSE | ZIP

mcp-config.md (2591B)

      1 # MCP Integration — Configuration and Samples
      2 
      3 MCP (Model Context Protocol) servers extend Squad with tools for external services — Trello, Aspire dashboards, Azure, Notion, and more. The user configures MCP servers in their environment; Squad discovers and uses them.
      4 
      5 > **Full patterns:** Read `.squad/skills/mcp-tool-discovery/SKILL.md` for discovery patterns, domain-specific usage, and graceful degradation.
      6 
      7 ## Config File Locations
      8 
      9 Users configure MCP servers at these locations (checked in priority order):
     10 1. **Repository-level:** `.copilot/mcp-config.json` (team-shared, committed to repo)
     11 2. **Workspace-level:** `.vscode/mcp.json` (VS Code workspaces)
     12 3. **User-level:** `~/.copilot/mcp-config.json` (personal)
     13 4. **CLI override:** `--additional-mcp-config` flag (session-specific)
     14 
     15 ## Sample Config — Trello
     16 
     17 ```json
     18 {
     19   "mcpServers": {
     20     "trello": {
     21       "command": "npx",
     22       "args": ["-y", "@trello/mcp-server"],
     23       "env": {
     24         "TRELLO_API_KEY": "${TRELLO_API_KEY}",
     25         "TRELLO_TOKEN": "${TRELLO_TOKEN}"
     26       }
     27     }
     28   }
     29 }
     30 ```
     31 
     32 ## Sample Config — GitHub
     33 
     34 ```json
     35 {
     36   "mcpServers": {
     37     "github": {
     38       "command": "npx",
     39       "args": ["-y", "@modelcontextprotocol/server-github"],
     40       "env": {
     41         "GITHUB_TOKEN": "${GITHUB_TOKEN}"
     42       }
     43     }
     44   }
     45 }
     46 ```
     47 
     48 ## Sample Config — Azure
     49 
     50 ```json
     51 {
     52   "mcpServers": {
     53     "azure": {
     54       "command": "npx",
     55       "args": ["-y", "@azure/mcp-server"],
     56       "env": {
     57         "AZURE_SUBSCRIPTION_ID": "${AZURE_SUBSCRIPTION_ID}",
     58         "AZURE_CLIENT_ID": "${AZURE_CLIENT_ID}",
     59         "AZURE_CLIENT_SECRET": "${AZURE_CLIENT_SECRET}",
     60         "AZURE_TENANT_ID": "${AZURE_TENANT_ID}"
     61       }
     62     }
     63   }
     64 }
     65 ```
     66 
     67 ## Sample Config — Aspire
     68 
     69 ```json
     70 {
     71   "mcpServers": {
     72     "aspire": {
     73       "command": "npx",
     74       "args": ["-y", "@aspire/mcp-server"],
     75       "env": {
     76         "ASPIRE_DASHBOARD_URL": "${ASPIRE_DASHBOARD_URL}"
     77       }
     78     }
     79   }
     80 }
     81 ```
     82 
     83 ## Authentication Notes
     84 
     85 - **GitHub MCP requires a separate token** from the `gh` CLI auth. Generate at https://github.com/settings/tokens
     86 - **Trello requires API key + token** from https://trello.com/power-ups/admin
     87 - **Azure requires service principal credentials** — see Azure docs for setup
     88 - **Aspire uses the dashboard URL** — typically `http://localhost:18888` during local dev
     89 
     90 Auth is a real blocker for some MCP servers. Users need separate tokens for GitHub MCP, Azure MCP, Trello MCP, etc. This is a documentation problem, not a code problem.