Servidores MCP

Puedes añadir herramientas externas a Dropstone usando el Model Context Protocol, o MCP. Dropstone admite tanto servidores locales como remotos.

Una vez añadidas, las herramientas MCP están automáticamente disponibles para el LLM junto con las herramientas integradas.

Advertencias

Cuando utilizas un servidor MCP, se añade al contexto. Esto puede acumularse rápidamente si tienes muchas herramientas. Por eso recomendamos ser cuidadoso con qué servidores MCP utilizas.

Ciertos servidores MCP, como el servidor MCP de GitHub, tienden a añadir muchos tokens y pueden exceder fácilmente el límite de contexto.

Habilitar

Puedes definir servidores MCP en tu configuración de Dropstone bajo mcp. Añade cada MCP con un nombre único. Puedes referirte a ese MCP por nombre al solicitar al LLM.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "name-of-mcp-server": {
      // ...
      "enabled": true,
    },
    "name-of-other-mcp-server": {
      // ...
    },
  },
}

También puedes deshabilitar un servidor estableciendo enabled a false. Esto es útil si deseas deshabilitar temporalmente un servidor sin eliminarlo de tu configuración.

Anulación de valores predeterminados remotos

Las organizaciones pueden proporcionar servidores MCP predeterminados a través de su punto final .well-known/dropstone. Estos servidores pueden estar deshabilitados por defecto, permitiendo a los usuarios optar por los que necesitan.

Para habilitar un servidor específico de la configuración remota de tu organización, añádelo a tu configuración local con enabled: true:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "jira": {
      "type": "remote",
      "url": "https://jira.example.com/mcp",
      "enabled": true
    }
  }
}

Los valores de tu configuración local anulan los valores predeterminados remotos. Consulta precedencia de configuración para más detalles.

Local

Añade servidores MCP locales usando type establecido a "local" dentro del objeto MCP.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-local-mcp-server": {
      "type": "local",
      // Or ["bun", "x", "my-mcp-command"]
      "command": ["npx", "-y", "my-mcp-command"],
      "enabled": true,
      "environment": {
        "MY_ENV_VAR": "my_env_var_value",
      },
    },
  },
}

El comando es cómo se inicia el servidor MCP local. También puedes pasar una lista de variables de entorno.

Por ejemplo, aquí te mostramos cómo puedes añadir el servidor MCP de prueba @modelcontextprotocol/server-everything.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "mcp_everything": {
      "type": "local",
      "command": ["npx", "-y", "@modelcontextprotocol/server-everything"],
    },
  },
}

Y para usarlo puedo añadir use the mcp_everything tool a mis solicitudes.

use the mcp_everything tool to add the number 3 and 4

Opciones

Aquí están todas las opciones para configurar un servidor MCP local.

Remoto

Añade servidores MCP remotos estableciendo type a "remote".

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-remote-mcp": {
      "type": "remote",
      "url": "https://my-mcp-server.com",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer MY_API_KEY"
      }
    }
  }
}

La url es la URL del servidor MCP remoto y con la opción headers puedes pasar una lista de encabezados.

Opciones

OAuth

Dropstone maneja automáticamente la autenticación OAuth para servidores MCP remotos. Cuando un servidor requiere autenticación, Dropstone:

1. Detecta la respuesta 401 e inicia el flujo OAuth
2. Usa Dynamic Client Registration (RFC 7591) si es compatible con el servidor
3. Almacena tokens de forma segura para futuras solicitudes

Automático

Para la mayoría de servidores MCP habilitados para OAuth, no se necesita configuración especial. Solo configura el servidor remoto:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-oauth-server": {
      "type": "remote",
      "url": "https://mcp.example.com/mcp"
    }
  }
}

Si el servidor requiere autenticación, Dropstone te pedirá que te autentiques cuando intentes usarlo por primera vez. Si no, puedes activar manualmente el flujo con dropstone mcp auth <server-name>.

Pre-registrado

Si tienes credenciales de cliente del proveedor del servidor MCP, puedes configurarlas:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-oauth-server": {
      "type": "remote",
      "url": "https://mcp.example.com/mcp",
      "oauth": {
        "clientId": "{env:MY_MCP_CLIENT_ID}",
        "clientSecret": "{env:MY_MCP_CLIENT_SECRET}",
        "scope": "tools:read tools:execute"
      }
    }
  }
}

Autenticación

Puedes activar manualmente la autenticación o gestionar credenciales.

Auténticate con un servidor MCP específico:

dropstone mcp auth my-oauth-server

Lista todos los servidores MCP y su estado de autenticación:

dropstone mcp list

Elimina credenciales almacenadas:

dropstone mcp logout my-oauth-server

El comando mcp auth abrirá tu navegador para autorización. Después de autorizar, Dropstone almacenará los tokens de forma segura en ~/.local/share/dropstone/mcp-auth.json.

Deshabilitación de OAuth

Si deseas deshabilitar OAuth automático para un servidor (por ejemplo, para servidores que usan claves API en su lugar), establece oauth a false:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-api-key-server": {
      "type": "remote",
      "url": "https://mcp.example.com/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:MY_API_KEY}"
      }
    }
  }
}

Opciones de OAuth

Depuración

Si un servidor MCP remoto falla en la autenticación, puedes diagnosticar problemas con:

# Ver estado de autenticación para todos los servidores con capacidad OAuth
dropstone mcp auth list

# Depurar conexión y flujo OAuth para un servidor específico
dropstone mcp debug my-oauth-server

El comando mcp debug muestra el estado de autenticación actual, prueba la conectividad HTTP e intenta el flujo de descubrimiento de OAuth.

Gestionar

Tus MCPs están disponibles como herramientas en Dropstone, junto con las herramientas integradas. Así que puedes gestionarlos a través de la configuración de Dropstone como cualquier otra herramienta.

Global

Esto significa que puedes habilitarlos o deshabilitarlos globalmente.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-mcp-foo": {
      "type": "local",
      "command": ["bun", "x", "my-mcp-command-foo"]
    },
    "my-mcp-bar": {
      "type": "local",
      "command": ["bun", "x", "my-mcp-command-bar"]
    }
  },
  "tools": {
    "my-mcp-foo": false
  }
}

También podemos usar un patrón glob para deshabilitar todos los MCPs coincidentes.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-mcp-foo": {
      "type": "local",
      "command": ["bun", "x", "my-mcp-command-foo"]
    },
    "my-mcp-bar": {
      "type": "local",
      "command": ["bun", "x", "my-mcp-command-bar"]
    }
  },
  "tools": {
    "my-mcp*": false
  }
}

Aquí estamos usando el patrón glob my-mcp* para deshabilitar todos los MCPs.

Por agente

Si tienes un gran número de servidores MCP, es posible que desees habilitarlos solo por agente y deshabilitarlos globalmente. Para hacer esto:

1. Deshabilítalo como herramienta globalmente.
2. En tu configuración de agente, habilita el servidor MCP como herramienta.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-mcp": {
      "type": "local",
      "command": ["bun", "x", "my-mcp-command"],
      "enabled": true
    }
  },
  "tools": {
    "my-mcp*": false
  },
  "agent": {
    "my-agent": {
      "tools": {
        "my-mcp*": true
      }
    }
  }
}

Patrones glob

El patrón glob usa patrones simples de globbing regex:

• * coincide con cero o más de cualquier carácter (por ejemplo, "my-mcp*" coincide con my-mcp_search, my-mcp_list, etc.)
• ? coincide exactamente con un carácter
• Todos los demás caracteres coinciden literalmente

"mymcpservername_*": false

Ejemplos

A continuación se muestran ejemplos de algunos servidores MCP comunes. Ponte en contacto si deseas que se documente otro.

Sentry

Añade el servidor MCP de Sentry para interactuar con tus proyectos e incidencias de Sentry.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "sentry": {
      "type": "remote",
      "url": "https://mcp.sentry.dev/mcp",
      "oauth": {}
    }
  }
}

Después de añadir la configuración, auténticate con Sentry:

dropstone mcp auth sentry

Esto abrirá una ventana del navegador para completar el flujo OAuth y conectar Dropstone a tu cuenta de Sentry.

Una vez autenticado, puedes usar herramientas de Sentry en tus solicitudes para consultar incidencias, proyectos y datos de errores.

Show me the latest unresolved issues in my project. use sentry

Context7

Añade el servidor MCP de Context7 para buscar en documentos.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "context7": {
      "type": "remote",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Si te has registrado para una cuenta gratuita, puedes usar tu clave API y obtener límites de velocidad más altos.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "context7": {
      "type": "remote",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "{env:CONTEXT7_API_KEY}"
      }
    }
  }
}

Aquí asumimos que tienes la variable de entorno CONTEXT7_API_KEY establecida.

Añade use context7 a tus solicitudes para usar el servidor MCP de Context7.

Configure a Cloudflare Worker script to cache JSON API responses for five minutes. use context7

Alternativamente, puedes añadir algo como esto a tu AGENTS.md.

When you need to search docs, use `context7` tools.

Grep by Vercel

Añade el servidor MCP Grep by Vercel para buscar fragmentos de código en GitHub.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "gh_grep": {
      "type": "remote",
      "url": "https://mcp.grep.app"
    }
  }
}

Como nombramos nuestro servidor MCP gh_grep, puedes añadir use the gh_grep tool a tus solicitudes para que el agente lo use.

What's the right way to set a custom domain in an SST Astro component? use the gh_grep tool

Alternativamente, puedes añadir algo como esto a tu AGENTS.md.

If you are unsure how to do something, use `gh_grep` to search code examples from GitHub.