Servidores MCP Personalizados
Além dos conectores no catálogo do Rephlo, você pode conectar um servidor MCP personalizado que você mesmo opera — ou um operado por alguém em quem você confia. Isso é para usuários avançados que já têm um servidor MCP e um token para acessá-lo.
Servidores personalizados são adicionados no aplicativo desktop em Settings → Connectors → Add custom connector. Não há interface web para isso; tudo acontece localmente na sua máquina.
Antes de começar
Você vai precisar de:
- Um servidor MCP que você consiga acessar (seu comando ou sua URL).
- Um bearer token para esse servidor, caso ele exija autenticação.
Hoje, a autenticação é apenas por bearer token. Servidores personalizados atualmente autenticam com um único bearer token pré-compartilhado — você cola um token, e o Rephlo o envia em cada solicitação. Servidores personalizados baseados em OAuth (nos quais você faz login por um navegador, como no Notion) ainda não são suportados e chegarão em uma versão futura.
Adicionando um servidor personalizado
- Abra Settings → Connectors e clique em Add custom connector.
- Dê ao servidor um nome para que você possa reconhecê-lo depois.
- Escolha um transporte — como o Rephlo se comunica com o servidor:
- Streamable HTTP — o Rephlo se conecta a uma URL do servidor pela rede.
- Stdio — o Rephlo inicia um executável local e se comunica com ele diretamente na sua máquina.
- Preencha as configurações específicas do transporte (veja a tabela abaixo).
- Cole o bearer token do servidor.
- Salve. O Rephlo se conecta, pergunta ao servidor quais ferramentas ele oferece, e as ferramentas do servidor ficam disponíveis no chat.
O painel Add custom connector, com seleção de transporte e o campo de bearer token.
Configurações de transporte
| Transporte | Obrigatório | Opcional |
|---|---|---|
| Streamable HTTP | URL do servidor | Um bearer token para autenticação |
| Stdio | Caminho do executável a iniciar | Argumentos |
O próprio catálogo de conectores do Rephlo fixa alguns servidores a um hash binário SHA-256 para verificação extra, mas isso é gerenciado pelo lado do Rephlo — não é um campo que você define ao adicionar seu próprio conector personalizado.
Onde seus dados ficam armazenados
- Servidores personalizados e seus bearer tokens são armazenados no seu dispositivo, criptografados em repouso. Eles não são enviados ao backend do Rephlo.
- As chamadas de ferramentas de servidores personalizados são executadas diretamente do seu desktop até o servidor — elas não passam pela nuvem do Rephlo.
- Como em todos os conectores, os resultados das ferramentas ficam na memória durante a sessão, e o log de auditoria local registra apenas o nome da ferramenta, a duração e o status — nunca os argumentos ou o conteúdo.
Solução de problemas
O servidor rejeita a conexão (401 / não autorizado). O bearer token está incorreto ou foi rotacionado. Remova o servidor e adicione-o novamente com o token correto.
A conexão expira (time-out). Verifique se a URL do servidor está acessível e se o servidor responde com rapidez razoável — as chamadas de ferramentas têm um limite de tempo fixo. Se o servidor for simplesmente lento, investigue seu desempenho ou disponibilidade.
As ferramentas não aparecem, ou as chamadas de ferramentas falham ao serem processadas. O servidor precisa falar MCP válido e declarar suas ferramentas quando o Rephlo se conecta. Confirme se o servidor emite definições e respostas de ferramentas MCP bem formadas.