Você vai conectar dois servidores
Cada um faz uma coisa, e você adiciona um de cada vez.
| Studio | https://mcp-studio.alysoft.com.br/mcpOnde a IA cria e altera a estrutura das suas aplicações. Comece por ele. |
|---|---|
| Run | https://mcp-run.alysoft.com.br/run/{id-da-aplicação}/mcpOnde a IA cadastra e consulta os dados. Um endereço por aplicação, que só existe depois que você publica. |
A lista das suas aplicações e os endereços delas ficam em Minha conta.
Antes de tudo: a sua credencial
Só é preciso se você for usar chave de API. Se escolher entrar com login (OAuth), pule esta parte — o assistente cuida de tudo.
- Abra Minha conta e entre.
- Em Chaves de API, dê um nome à chave — por exemplo “Claude no notebook”.
- Clique em Gerar chave e copie na hora.
A chave começa com msr_ e aparece uma única vez. Se perder, revogue e gere
outra — o servidor não guarda a chave, só uma impressão dela.
Escolha seu assistente
Dentro de cada um, os métodos aparecem do mais recomendado para o menos.
No app do Claude ou em claude.ai, vá em Configurações → Conectores → Adicionar → Adicionar conector personalizado.
Entrar com login
Padrão atualNada de chave para copiar e colar. Você faz login uma vez e autoriza o acesso.
- Nome: MCP Studio
- URL:
https://mcp-studio.alysoft.com.br/mcp - Clique em Continuar.
- Em Autenticação, escolha Sempre obrigatório.
- Salve e clique em Vincular. Abre a tela de login, você autoriza, e pronto.
Depois repita com a URL do Run da sua aplicação.
Esse acesso fica listado em Minha conta, em Aplicativos conectados, e você desconecta quando quiser.
Chave no cabeçalho
Amplamente aceitoBom quando você quer uma credencial fixa, que não expira.
- Nome: MCP Studio
- URL:
https://mcp-studio.alysoft.com.br/mcp - Clique em Continuar.
- Deixe a autenticação em Nenhum.
- Em Cabeçalhos de requisição, clique em Adicionar cabeçalho.
- Chave
Authorization- Valor
Bearer msr_sua-chave
Não esqueça a palavra Bearer e o espaço antes da chave.
O valor é guardado com segurança e não é exibido de novo.
Chave na URL
AlternativaSó se por algum motivo você não conseguir usar cabeçalho. A chave vai dentro do endereço:
https://mcp-studio.alysoft.com.br/k/msr_sua-chave/mcpIsso é um link secreto. Quem vir a URL entra como você — e URLs escapam com facilidade em prints, históricos e mensagens. Prefira o cabeçalho.
No terminal, um comando por servidor.
Entrar com login
Padrão atualAdicione o servidor sem credencial nenhuma:
claude mcp add --transport http mcp-studio https://mcp-studio.alysoft.com.br/mcpNa primeira vez que for usar, o Claude Code abre o navegador para você entrar e autorizar.
Chave no cabeçalho
Amplamente aceitoclaude mcp add --transport http mcp-studio https://mcp-studio.alysoft.com.br/mcp \
--header "Authorization: Bearer msr_sua-chave"E para o Run, com o id da sua aplicação:
claude mcp add --transport http minha-app \
https://mcp-run.alysoft.com.br/run/ID-DA-APLICACAO/mcp \
--header "Authorization: Bearer msr_sua-chave"Rodar no seu computador
AvançadoEm vez de falar com o servidor, você roda o aplicativo na sua própria máquina. Os dados ficam só com você, e não há credencial a informar.
- Baixe o aplicativo local e guarde num lugar fixo.
- Acrescente ao arquivo de configuração do Claude Code:
{
"mcpServers": {
"mcp-studio": {
"command": "java",
"args": [
"-jar", "CAMINHO/ONDE/VOCE/SALVOU/mcp-studio-local.jar",
"--studio.mcp.transport=stdio"
]
}
}
}Precisa do Java 21 instalado. Se o comando java não for
encontrado, troque por seu caminho completo — o aplicativo não carrega o mesmo
ambiente do seu terminal.
Vá em Configurações → Plug-ins → MCPs → Conectar a um MCP personalizado.
Chave no cabeçalho
Recomendado aquiEscolha o tipo HTTP com streaming.
- Nome
- MCP Studio
- URL
https://mcp-studio.alysoft.com.br/mcp
Em Cabeçalhos, adicione:
- Chave
Authorization- Valor
Bearer msr_sua-chave
Token do portador
Amplamente aceitoMesma tela, tipo HTTP com streaming, usando o campo próprio para token em vez do cabeçalho.
- URL
https://mcp-studio.alysoft.com.br/mcp- Variável de ambiente de token do portador
- o nome de uma variável de ambiente que contenha a sua chave
msr_…
O campo espera o nome da variável, não a chave em si.
Rodar no seu computador
AvançadoEscolha o tipo STDIO e baixe o aplicativo local.
- Comando para iniciar
java- Argumentos
-jar
CAMINHO/ONDE/VOCE/SALVOU/mcp-studio-local.jar
--studio.mcp.transport=stdio- Diretório de trabalho
- pode deixar em branco
Um argumento por campo. Precisa do Java 21 instalado.
Qualquer cliente que fale MCP funciona. O protocolo é JSON-RPC 2.0 sobre HTTP.
Listar o que a IA pode fazer
curl -s -X POST https://mcp-studio.alysoft.com.br/mcp \
-H "Authorization: Bearer msr_sua-chave" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Criar uma aplicação
curl -s -X POST https://mcp-studio.alysoft.com.br/mcp \
-H "Authorization: Bearer msr_sua-chave" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
"params":{"name":"create_application","arguments":{"name":"Controle de Vendas"}}}'Onde a credencial pode ir
Aceitamos as quatro formas, nesta ordem de preferência:
Authorization: Bearer |
cabeçalho Padrão atual |
|---|---|
X-API-Key |
cabeçalho alternativo Aceito |
/k/msr_…/mcp |
dentro da URL Alternativa |
?api_key=msr_… |
na query Último recurso |
Login com OAuth
Seu cliente descobre tudo sozinho a partir de
/.well-known/oauth-protected-resource. É OAuth 2.1 com registro dinâmico de
cliente e PKCE obrigatório — nada a configurar do seu lado além de escolher OAuth.
Conferir pelo navegador
GET /api/applications | suas aplicações |
|---|---|
GET /api/applications/{id}/structure | a estrutura em texto |
GET /api/applications/{id}/validation | o que está inconsistente |
GET /api/applications/{id}/compatibility | o impacto das alterações |
Conectou. E agora?
Fale com sua IA em português mesmo. Alguns exemplos para começar:
- “Quero controlar as vendas de carros que faço. Monta pra mim.”
- “Me mostra como ficou a estrutura.”
- “Publica.”
- Adicione o conector do Run da aplicação e siga: “Cadastra a venda do Civic para a Ana, 175 mil, concluída.”
Se algo não funcionar
Diz que não está autorizado
A chave não chegou ou foi revogada. Confira se o valor do cabeçalho começa com
Bearer — com o espaço — e veja em Minha conta se a chave
ainda está ativa.
A opção de login aparece apagada
O servidor está aceitando conexões sem credencial no momento. Use chave no cabeçalho, ou peça a quem administra para exigir credencial.
O endereço do Run não é encontrado
Três motivos possíveis, e a resposta é a mesma nos três de propósito: o id está errado, a aplicação nunca foi publicada, ou ela é de outra conta. Confirme o endereço em Minha conta.
Conectou mas a IA diz que não tem nada a fazer
No Run, isso quer dizer que a aplicação publicada ainda não tem estruturas ativas. Volte ao Studio, modele e publique.
Publiquei uma mudança e a IA não viu
Não deveria acontecer — a mudança vale na conversa seguinte. Peça para ela listar as ferramentas de novo; se ainda assim não aparecer, a publicação pode não ter concluído.