Servidores MCP

Você pode adicionar ferramentas externas ao Dropstone usando o Model Context Protocol, ou MCP. Dropstone suporta tanto servidores locais quanto remotos.

Uma vez adicionadas, as ferramentas MCP ficam automaticamente disponíveis para o LLM junto com as ferramentas integradas.

Ressalvas

Quando você usa um servidor MCP, ele adiciona ao contexto. Isso pode se acumular rapidamente se você tiver muitas ferramentas. Portanto, recomendamos ter cuidado com quais servidores MCP você usa.

Certos servidores MCP, como o servidor GitHub MCP, tendem a adicionar muitos tokens e podem facilmente exceder o limite de contexto.

Ativar

Você pode definir servidores MCP em sua configuração do Dropstone sob mcp. Adicione cada MCP com um nome único. Você pode se referir a esse MCP pelo nome ao fazer prompts para o LLM.

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

Você também pode desativar um servidor definindo enabled como false. Isso é útil se você quiser desativar temporariamente um servidor sem removê-lo da sua configuração.

Substituindo padrões remotos

Organizações podem fornecer servidores MCP padrão através de seu endpoint .well-known/dropstone. Esses servidores podem estar desativados por padrão, permitindo que os usuários optem pelos que precisam.

Para ativar um servidor específico da configuração remota da sua organização, adicione-o à sua configuração local com enabled: true:

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

Seus valores de configuração local substituem os padrões remotos. Veja precedência de configuração para mais detalhes.

Local

Adicione servidores MCP locais usando type como "local" dentro do 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",
      },
    },
  },
}

O comando é como o servidor MCP local é iniciado. Você também pode passar uma lista de variáveis de ambiente.

Por exemplo, aqui está como você pode adicionar o servidor MCP de teste @modelcontextprotocol/server-everything.

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

E para usá-lo, posso adicionar use the mcp_everything tool aos meus prompts.

use the mcp_everything tool to add the number 3 and 4

Opções

Aqui estão todas as opções para configurar um servidor MCP local.

Remoto

Adicione servidores MCP remotos definindo 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"
      }
    }
  }
}

A url é a URL do servidor MCP remoto e com a opção headers você pode passar uma lista de cabeçalhos.

Opções

OAuth

Dropstone trata automaticamente a autenticação OAuth para servidores MCP remotos. Quando um servidor requer autenticação, Dropstone irá:

1. Detectar a resposta 401 e iniciar o fluxo OAuth
2. Usar Dynamic Client Registration (RFC 7591) se suportado pelo servidor
3. Armazenar tokens com segurança para futuras solicitações

Automático

Para a maioria dos servidores MCP habilitados para OAuth, nenhuma configuração especial é necessária. Apenas configure o servidor remoto:

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

Se o servidor requer autenticação, Dropstone o solicitará quando você tentar usá-lo pela primeira vez. Se não, você pode disparar manualmente o fluxo com dropstone mcp auth <server-name>.

Pré-registrado

Se você tiver credenciais de cliente do provedor do servidor MCP, você pode configurá-las:

{
  "$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"
      }
    }
  }
}

Autenticando

Você pode disparar manualmente a autenticação ou gerenciar credenciais.

Autentique com um servidor MCP específico:

dropstone mcp auth my-oauth-server

Liste todos os servidores MCP e seu status de autenticação:

dropstone mcp list

Remova credenciais armazenadas:

dropstone mcp logout my-oauth-server

O comando mcp auth abrirá seu navegador para autorização. Depois que você autorizar, Dropstone armazenará os tokens com segurança em ~/.local/share/dropstone/mcp-auth.json.

Desativando OAuth

Se você quiser desativar OAuth automático para um servidor (por exemplo, para servidores que usam chaves de API), defina oauth como 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}"
      }
    }
  }
}

Opções de OAuth

Depuração

Se um servidor MCP remoto estiver falhando na autenticação, você pode diagnosticar problemas com:

# Ver status de autenticação para todos os servidores com capacidade OAuth
dropstone mcp auth list

# Depurar conexão e fluxo OAuth para um servidor específico
dropstone mcp debug my-oauth-server

O comando mcp debug mostra o status de autenticação atual, testa conectividade HTTP e tenta o fluxo de descoberta OAuth.

Gerenciar

Seus MCPs estão disponíveis como ferramentas no Dropstone, junto com as ferramentas integradas. Portanto, você pode gerenciá-los através da configuração do Dropstone como qualquer outra ferramenta.

Global

Isso significa que você pode ativá-los ou desativá-los 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
  }
}

Também podemos usar um padrão glob para desativar todos os MCPs correspondentes.

{
  "$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
  }
}

Aqui estamos usando o padrão glob my-mcp* para desativar todos os MCPs.

Por agente

Se você tiver um grande número de servidores MCP, você pode querer ativá-los apenas por agente e desativá-los globalmente. Para fazer isso:

1. Desative-o como uma ferramenta globalmente.
2. Na sua configuração de agente, ative o servidor MCP como uma ferramenta.

{
  "$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
      }
    }
  }
}

Padrões glob

O padrão glob usa padrões simples de globbing com regex:

• * corresponde a zero ou mais de qualquer caractere (por exemplo, "my-mcp*" corresponde a my-mcp_search, my-mcp_list, etc.)
• ? corresponde a exatamente um caractere
• Todos os outros caracteres correspondem literalmente

"mymcpservername_*": false

Exemplos

Abaixo estão exemplos de alguns servidores MCP comuns. Entre em contato se você gostaria que outro fosse documentado.

Sentry

Adicione o servidor Sentry MCP para interagir com seus projetos e problemas do Sentry.

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

Após adicionar a configuração, autentique com o Sentry:

dropstone mcp auth sentry

Isso abrirá uma janela do navegador para completar o fluxo OAuth e conectar Dropstone à sua conta Sentry.

Uma vez autenticado, você pode usar ferramentas Sentry em seus prompts para consultar problemas, projetos e dados de erro.

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

Context7

Adicione o servidor Context7 MCP para pesquisar através de documentos.

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

Se você se inscreveu em uma conta gratuita, você pode usar sua chave de API e obter limites de taxa mais 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}"
      }
    }
  }
}

Aqui estamos assumindo que você tem a variável de ambiente CONTEXT7_API_KEY definida.

Adicione use context7 aos seus prompts para usar o servidor Context7 MCP.

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

Alternativamente, você pode adicionar algo assim ao seu AGENTS.md.

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

Grep by Vercel

Adicione o servidor MCP Grep by Vercel para pesquisar através de trechos de código no GitHub.

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

Como nomeamos nosso servidor MCP como gh_grep, você pode adicionar use the gh_grep tool aos seus prompts para fazer o agente usá-lo.

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

Alternativamente, você pode adicionar algo assim ao seu AGENTS.md.

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