Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

docs-site: "Connect to editor" one-click MCP install buttons (Cursor / VS Code)

Abierto
  • ¿Algo no está bien?
#37 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
35/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Estancado
Área
documentation, frontend

Línea de trabajo

Empieza en el frontend de docs-site, no en este repositorio, y localiza la página de configuración o integración de MCP. Implementa los puntos de entrada para Cursor, VS Code, Claude Code y la entrada manual de JSON utilizando el endpoint alojado y los payloads proporcionados. Verifica cada elemento de QA, incluidos los enlaces de VS Code lanzados desde el navegador, el manejo de Insiders y una llamada a la herramienta de docs posterior a la instalación.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Note: This tracks a docs-site UI change, filed here for visibility. The implementation lives in the docs-site frontend, not in this repo — the MCP server is only the install target. Transfer/move to the docs-site tracker once one exists.

Summary

Add "Connect to editor" one-click install buttons for the Mapbox Docs MCP server on the docs site, following the Redocly/Sinch pattern (see developers.sinch.com). Clicking a button hands the editor a pre-filled MCP config so users skip hand-editing JSON.

Why this fits us well

  • The docs MCP server is token-free and already hosted at https://mcp-docs.mapbox.com/mcp, so the button is a genuine one-click install — no API key paste, no local install.
  • Smoother than the reference implementation: Sinch's buttons install a local server; ours points at the hosted endpoint.

Scope

  • This is a docs-site frontend change. No change to @mapbox/mcp-docs-server; the server is the target the links point at.

Deliverables

  • Cursor button — cursor://anysphere.cursor-deeplink/mcp/install?name=mapbox-docs&config=<base64>
  • VS Code button — browser-safe https://insiders.vscode.dev/redirect/mcp/install?name=mapbox-docs&config=<urlencoded> form (config uses type:http for the remote server)
  • Claude Code — copyable command, NOT a deep link (no URL scheme exists): claude mcp add mapbox-docs --transport http https://mcp-docs.mapbox.com/mcp
  • Manual-setup fallback (raw mcpServers JSON) for editors without MCP-install-URL support

Payloads (production, hosted endpoint)

  • Cursor config (raw): {"url":"https://mcp-docs.mapbox.com/mcp"} → base64 eyJ1cmwiOiJodHRwczovL21jcC1kb2NzLm1hcGJveC5jb20vbWNwIn0=
  • VS Code config (raw): {"type":"http","url":"https://mcp-docs.mapbox.com/mcp"} → URL-encoded %7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp-docs.mapbox.com%2Fmcp%22%7D
  • Server name: mapbox-docs

Caveats

  • Custom-scheme links trigger a browser "open external app?" prompt — expected; button copy should set that expectation.
  • Requires an editor build with MCP-install-URL support (current Cursor and recent VS Code). Confirm the minimum VS Code version before publishing.
  • VS Code Insiders users may need the vscode-insiders: variant, or let the redirect resolve.

QA

  • Cursor link opens install prompt and registers mapbox-docs at the hosted URL
  • VS Code redirect link works when clicked from a browser
  • VS Code Insiders users land in Insiders
  • Claude Code command copies cleanly and runs without a token
  • Manual-setup fallback reachable for unsupported editors
  • Post-install, a docs tool call returns results against mcp-docs.mapbox.com

Reference

Full handoff spec with live buttons, drop-in HTML/markdown snippets, and payload reference prepared separately (artifact). Origin: Slack feedback from Andrew Sepic (2026-07-08).

Lenguaje dominante
TypeScript
Estrellas
1
Forks
1
Merge medio
2 d 23 h
PR fusionados (30 d)
1

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de mapbox/mcp-docs-server

Todos los issues de mapbox/mcp-docs-server

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.