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 usas un servidor MCP, este añade contenido al contexto. Esto puede acumularse rápidamente si tienes muchas herramientas. Por eso recomendamos tener cuidado con qué servidores MCP usas.

Ciertos servidores MCP, como el servidor MCP de GitHub, tienden a añadir muchos tokens y pueden superar 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 dar instrucciones 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 en false. Esto es útil si quieres deshabilitar temporalmente un servidor sin eliminarlo de tu configuración.

Sobrescribir los valores predeterminados remotos

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

Para habilitar un servidor específico desde 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 sobrescriben los valores predeterminados remotos. Consulta precedencia de configuración para más detalles.

Local

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

{
  "$schema": "https://dropstone.io/schema/config.json",
  "mcp": {
    "my-local-mcp-server": {
      "type": "local",
      // O ["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, así es como 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 instrucciones.

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 como "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 cabeceras.

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 Registro Dinámico de Clientes (RFC 7591) si el servidor lo admite
3. Almacena los tokens de forma segura para solicitudes futuras

Automático

Para la mayoría de los servidores MCP con 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 la primera vez que intentes usarlo. 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 las credenciales.

Autentícate 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 las credenciales almacenadas:

dropstone mcp logout my-oauth-server

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

Deshabilitar OAuth

Si quieres deshabilitar el OAuth automático para un servidor (por ejemplo, para servidores que usan claves API), establece oauth en 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 al autenticarse, puedes diagnosticar problemas con:

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

# Depurar la conexión y el 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 OAuth.

Gestionar

Tus MCP 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 MCP que coincidan.

{
  "$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 MCP.

Por agente

Si tienes un gran número de servidores MCP, puede que quieras 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 de globbing regex simples:

• * 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 quieres que documentemos otro.

Sentry

Añade el servidor MCP de Sentry para interactuar con tus proyectos y problemas 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, autentícate 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 las herramientas de Sentry en tus instrucciones para consultar problemas, 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 la documentación.

{
  "$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 configurada.

Añade use context7 a tus instrucciones 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 instrucciones 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.