/mcp",
"headers": {
"API_KEY": "Bearer ${env:AUTH_TOKEN}"
}
}
}
}
```
## Controles administrativos (Teams & Enterprises)
Os administradores da equipe podem ativar ou desativar o acesso ao MCP para a equipe, bem como adicionar à lista de permissões servidores MCP aprovados para uso pela equipe:
Configurações de MCP que podem ser definidas para sua equipe.
O link acima só funcionará se você tiver privilégios de administrador na sua equipe.
Por padrão, os usuários de uma equipe poderão configurar seus próprios servidores MCP. No entanto, assim que você adicionar um único servidor MCP à lista de permissões, **todos os servidores que não estiverem nessa lista serão bloqueados** para sua equipe.
### Como funciona a correspondência de servidor
Quando você coloca um servidor MCP na lista de permissões, o sistema usa **correspondência por padrão regex** com as seguintes regras:
* **Correspondência da string completa**: todos os padrões são automaticamente ancorados (envolvidos por `^(?:pattern)$`) para evitar correspondências parciais
* **Campo de comando**: deve corresponder exatamente ou seguir o seu padrão regex
* **Array de argumentos**: cada argumento é comparado individualmente com seu padrão correspondente
* **Comprimento do array**: o número de argumentos deve corresponder exatamente entre a lista de permissões e a configuração do usuário
* **Caracteres especiais**: caracteres como `$`, `.`, `[`, `]`, `(`, `)` têm significado especial em regex e devem ser escapados com `\` se você quiser uma correspondência literal
### Opções de configuração
**Configuração da lista de permissões do administrador:**
* **Server ID**: `github-mcp-server`
* **Server Config (JSON)**: *(deixe em branco)*
```json theme={null}
{}
```
**Configuração de usuário correspondente (`mcp_config.json`):**
```json theme={null}
{
"mcpServers": {
"github-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
}
}
}
}
```
Isso permite que os usuários instalem o servidor MCP do GitHub com qualquer configuração válida, desde que o ID do servidor corresponda à entrada na plugin store.
**Configuração da lista de permissões do administrador:**
* **Server ID**: `github-mcp-server`
* **Server Config (JSON)**:
```json theme={null}
{
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": ""
}
}
```
**Configuração de usuário correspondente (`mcp_config.json`):**
```json theme={null}
{
"mcpServers": {
"github-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
}
}
}
}
```
Os usuários devem usar exatamente essa configuração; qualquer desvio em `command` ou `args` será bloqueado. A seção `env` pode ter valores diferentes.
**Configuração da lista de permissões do administrador:**
* **Server ID**: `python-mcp-server`
* **Server Config (JSON)**:
```json theme={null}
{
"command": "python3",
"args": ["/.*\\.py", "--port", "[0-9]+"]
}
```
**Configuração de usuário correspondente (`mcp_config.json`):**
```json theme={null}
{
"mcpServers": {
"python-mcp-server": {
"command": "python3",
"args": ["/home/user/my_server.py", "--port", "8080"],
"env": {
"PYTHONPATH": "/home/user/mcp"
}
}
}
}
```
Este exemplo oferece flexibilidade aos usuários, mantendo a segurança:
* A regex `/.*\\.py` corresponde a qualquer caminho de arquivo Python, como `/home/user/my_server.py`
* A regex `[0-9]+` corresponde a qualquer porta numérica, como `8080` ou `3000`
* Os usuários podem personalizar caminhos de arquivos e portas, enquanto os administradores garantem que apenas scripts Python sejam executados
### Padrões comuns de regex
| Padrão | Corresponde a | Exemplo |
| --------------- | -------------------------------- | ----------------------- |
| `.*` | Qualquer sequência de caracteres | `/home/user/script.py` |
| `[0-9]+` | Qualquer número | `8080`, `3000` |
| `[a-zA-Z0-9_]+` | Alfanumérico + underscore | `api_key_123` |
| `\\$HOME` | `$HOME` literal | `$HOME` (não expandido) |
| `\\.py` | `.py` literal | `script.py` |
| `\\[cli\\]` | `[cli]` literal | `mcp[cli]` |
## Notas
### Diretrizes de configuração do administrador
* **Variáveis de ambiente**: a seção `env` não usa correspondência por regex e pode ser configurada livremente pelos usuários
* **Ferramentas desativadas**: o array `disabledTools` é tratado separadamente e não faz parte da correspondência da lista de permissões
* **Diferenciação entre maiúsculas e minúsculas**: toda correspondência diferencia maiúsculas de minúsculas
* **Tratamento de erros**: padrões de regex inválidos serão registrados em log e resultarão em negação de acesso
* **Testes**: teste seus padrões de regex com cuidado - padrões excessivamente restritivos podem bloquear casos de uso legítimos
### Solução de problemas
Se os usuários relatarem que seus servidores MCP não estão funcionando após a inclusão na lista de permissões:
1. **Verifique a correspondência exata**: Certifique-se de que o padrão da lista de permissões corresponda exatamente à configuração do usuário
2. **Verifique o escape de regex**: Caracteres especiais podem precisar ser escapados (por exemplo, `\.` para pontos literais)
3. **Revise os logs**: Padrões de regex inválidos são registrados com avisos
4. **Teste os padrões**: Use um testador de regex para confirmar que seus padrões funcionam como esperado
Lembre-se: depois que você inclui qualquer servidor na lista de permissões, **todos os outros servidores são automaticamente bloqueados** para os membros da sua equipe.
### Informações gerais
* Como as chamadas de ferramentas do MCP podem invocar código escrito por implementadores de servidor diversos, não nos responsabilizamos
por falhas nessas chamadas de ferramentas do MCP. Reforçando:
* No momento, oferecemos suporte às [ferramentas](https://modelcontextprotocol.io/docs/concepts/tools), aos [recursos](https://modelcontextprotocol.io/docs/concepts/resources) e aos [prompts](https://modelcontextprotocol.io/docs/concepts/prompts) de um servidor MCP.
O Cascade oferece suporte a três [tipos de transporte](https://modelcontextprotocol.io/docs/concepts/transports) para servidores
MCP: `stdio`, `Streamable HTTP` e `SSE`.
O Cascade também oferece suporte a OAuth para cada tipo de transporte.
Para servidores `http`, a URL deve corresponder à do endpoint e ter um formato como `https://