O Claude Code tem um comando de uma linha para adicionar servidores MCP. A maioria dos outros clientes usa uma tela de configurações ou um arquivo JSON. A informação que você digita é a mesma em todos, então, depois de conhecer os três valores de que o Provedly precisa, você pode conectá-lo a qualquer ferramenta em que trabalhe.
Os três valores
Todo cliente MCP que aceita servidores remotos precisa das mesmas coisas:
- Transporte: HTTP. O servidor do Provedly usa streamable HTTP, então escolha a opção HTTP ou "remote", não stdio.
- URL:
https://provedly.app/mcp - Cabeçalho:
Authorization: Bearer provedly_YOUR_KEY
A chave vem de Settings, depois API keys, no painel do Provedly. Escolha Read only ou Read and write ao criá-la. Ela é mostrada uma única vez, começa com provedly_ e pode ser revogada quando você quiser. Se o seu cliente não consegue enviar um cabeçalho Authorization personalizado para um servidor remoto, ele ainda não consegue se conectar ao Provedly; nesse caso, a alternativa é a API REST.
Cursor
O Cursor lê os servidores MCP de um arquivo mcp.json, seja globalmente na sua pasta pessoal, dentro de .cursor/, seja por projeto, na pasta .cursor/ do projeto. No momento em que escrevemos, um servidor remoto com cabeçalho fica assim:
{
"mcpServers": {
"provedly": {
"url": "https://provedly.app/mcp",
"headers": {
"Authorization": "Bearer provedly_YOUR_KEY"
}
}
}
}
Salve o arquivo e abra as configurações de MCP do Cursor. A entrada provedly deve aparecer como ativada, com as ferramentas listadas. Se você colocou isso num arquivo do projeto, confira se essa pasta é commitada no git. Uma chave num arquivo commitado é uma chave vazada, e a solução é revogá-la no Provedly e criar uma nova.
Os editores mudam as telas de configuração com frequência, então, se o layout for diferente desta descrição, procure a opção de servidor remoto ou HTTP e informe a mesma URL e o mesmo cabeçalho.
Outras ferramentas compatíveis com MCP
O padrão se repete entre os clientes. Procure um jeito de adicionar um servidor remoto, HTTP ou "streamable HTTP", dê um nome a ele, cole a URL e adicione um cabeçalho. Alguns clientes têm um campo de cabeçalho no formulário; outros aceitam um bloco JSON parecido com o do Cursor. Seja qual for o formato, o nome do cabeçalho é Authorization e o valor é Bearer seguido da sua chave, com um único espaço.
Alguns clientes só aceitam servidores locais stdio. Esses não conseguem chegar ao Provedly diretamente. O Provedly não publica um wrapper local, então, para essas ferramentas, o caminho é a API REST em https://provedly.app/api/v1, com a mesma chave. O tour com curl cobre todos os endpoints.
Conferindo a conexão
Quando o cliente mostrar o servidor como conectado, faça uma pergunta cuja resposta você possa conferir:
Liste meus sites do Provedly e os widgets de cada um.
O assistente deve chamar list_sites e list_widgets e devolver nomes que batem com o painel. Se você criou uma chave somente leitura, qualquer tentativa de pausar, criar ou editar algo será recusada. Isso é esperado, e pedir uma mudança inofensiva é um bom jeito de confirmar que a chave faz o que você pensa.
Causas comuns de falha, mais ou menos em ordem de frequência:
| Sintoma | Causa habitual |
|---|---|
| O servidor mostra um erro de autenticação | Falta o prefixo Bearer ou há erro na chave |
| Funcionava ontem, falha hoje | A chave foi revogada em Settings |
| Ferramentas listadas, escritas recusadas | A chave é Read only |
| Uma retomada é recusada | Essa mudança ultrapassaria o limite do seu plano |
| O cliente não consegue adicionar o servidor | Ele só aceita servidores locais stdio |
O que fazer com isso
O cliente muda, as ferramentas não. Em qualquer ferramenta conectada você pode ler a sua conta, sites, widgets, barras e estatísticas, e com uma chave de escrita pode pausar ou retomar widgets, criar e atualizar barras e adicionar registros. Alguns prompts que funcionam bem para começar:
- "Qual widget teve mais cliques esta semana?"
- "Mostre todas as barras que estão rodando agora, com a data de término."
- "Me dê o snippet de instalação da minha loja."
Para uma lista mais longa, com o que cada um faz por trás, veja o livro de receitas de prompts. Se você está no Claude Code e não num editor, o guia do Claude Code tem a versão de uma linha.
Uma observação sobre equipes
Se várias pessoas de uma equipe conectarem seus editores, dê a cada uma a sua própria chave. A tela de API keys lista todas as chaves com nome e nível de acesso, então, quando alguém sai, você revoga a chave dessa pessoa e ninguém mais é afetado. Compartilhar uma chave com a equipe inteira torna isso impossível sem derrubar todo mundo de uma vez.
Perguntas frequentes
O servidor MCP do Provedly funciona no claude.ai ou no ChatGPT?
A configuração suportada é Claude Code, Cursor e outras ferramentas compatíveis com MCP que consigam se conectar a um servidor HTTP remoto com um cabeçalho Authorization. Não afirmamos suporte a outros produtos até que ele tenha sido construído e testado.
Devo usar uma configuração global ou do projeto no Cursor?
A global é mais simples e mantém a chave fora dos repositórios. Use a do projeto só se precisar de chaves diferentes por projeto e a pasta não for commitada.
Posso conectar duas contas do Provedly?
Sim. Adicione dois servidores com nomes diferentes, cada um com uma chave da respectiva conta. O assistente verá os dois conjuntos de ferramentas e você pode dizer de qual conta está falando.
Você pode criar uma chave em qualquer plano, inclusive o Free: comece aqui.