Files
SlipItIn/.github/skills/astro-sites-manager/references/install-mcp.md
Tim Krampitz 01046b01e4 Neue Skills, Referenzen & OpenWiki-Doku integriert
Umfangreiche Erweiterung der Skill-Bibliothek: Neue Skills für Humanisierung (Englisch/PT-BR), Design-Validierung, AI-SEO und Coolify-Deployment inkl. Regelwerke, Presets, Pattern-Referenzen, Testfälle und Automatisierungsskripte. Zusätzliche Skills für Revenue-Centric Design, Pier Cloud, OKF, Lebenslauf- und LinkedIn-Optimierung sowie zahlreiche Referenzdateien, Checklisten und YAML/JSON/Markdown-Templates. Einführung einer vollständigen OpenWiki-Dokumentation mit Architektur-, Domain- und Workflow-Beschreibungen, zentralem Index und automatisierten Updates. Modularer Aufbau, restriktive Lizenzen und umfassende Qualitäts- und Evaluationsmechanismen für alle neuen Inhalte.
2026-07-26 14:00:58 +02:00

3.2 KiB

Installing the Astro Docs MCP Server

The Astro Docs MCP server provides real-time access to the latest Astro documentation via the Model Context Protocol.

  • URL: https://mcp.docs.astro.build/mcp
  • Transport: Streamable HTTP
  • Tool: search_astro_docs
  • Source: Open-source, powered by kapa.ai

By Tool

Kiro CLI

kiro-cli mcp add --name astro-docs --scope global --command npx --args "-y" --args "mcp-remote" --args "https://mcp.docs.astro.build/mcp"

Or create/edit ~/.kiro/settings/mcp.json:

{
  "mcpServers": {
    "astro-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.docs.astro.build/mcp"],
      "env": {}
    }
  }
}

Claude Code CLI

claude mcp add --transport http astro-docs https://mcp.docs.astro.build/mcp

Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.astro-docs]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.docs.astro.build/mcp"]

Cursor

Use the deeplink or add to .cursor/mcp.json:

{
  "mcpServers": {
    "Astro docs": {
      "type": "http",
      "url": "https://mcp.docs.astro.build/mcp"
    }
  }
}

VS Code (Copilot Chat)

Add to .vscode/mcp.json:

{
  "mcpServers": {
    "Astro docs": {
      "type": "http",
      "url": "https://mcp.docs.astro.build/mcp"
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "Astro docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.docs.astro.build/mcp"]
    }
  }
}

Gemini CLI

Add to .gemini/settings.json:

{
  "mcpServers": {
    "Astro docs": {
      "httpUrl": "https://mcp.docs.astro.build/mcp"
    }
  }
}

Zed

Add to ~/.config/zed/settings.json:

{
  "context_servers": {
    "Astro docs": {
      "settings": {},
      "enabled": true,
      "url": "https://mcp.docs.astro.build/mcp"
    }
  }
}

Claude.ai / Claude Desktop

  1. Go to Settings → Connectors
  2. Click "Add custom connector"
  3. URL: https://mcp.docs.astro.build/mcp
  4. Name: Astro docs

Warp

Settings → AI → MCP Servers → Add:

{
  "mcpServers": {
    "Astro docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.docs.astro.build/mcp"],
      "start_on_launch": true
    }
  }
}

Generic (any tool supporting MCP)

Streamable HTTP (preferred):

{
  "mcpServers": {
    "Astro docs": {
      "type": "http",
      "url": "https://mcp.docs.astro.build/mcp"
    }
  }
}

Local Proxy (for tools that only support stdio):

{
  "mcpServers": {
    "Astro docs": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.docs.astro.build/mcp"]
    }
  }
}

Troubleshooting

Issue Fix
Server not responding Verify URL is exactly https://mcp.docs.astro.build/mcp
Tool not connecting Check internet access; some firewalls block MCP
Stale results MCP always fetches latest docs — no cache to clear
Local proxy crashes Ensure npx is in PATH and Node.js ≥ 18 installed

Issues: https://github.com/withastro/docs-mcp/issues