Utilize um cliente MCP que suporte HTTP Streamable e OAuth pré-registado com PKCE ou um token de portador configurado. O apoio ao cliente varia; o registo automático do cliente não está disponível.
URL do servidor MCP
https://api.remotegymp.com/mcpº Para auto-hospedado, utilize o mesmo caminho MCP no endereço HTTPS público da sua instalação. O seu cliente deve ser capaz de o alcançar. O endereço da cloud não faz proxy de pedidos para a sua instalação.
Ligue-se com OAuth
- º Em Definições, crie uma credencial com o MCP ativado e apenas as permissões de que o assistente necessita. Registe o URL de retorno de chamada exato fornecido pelo seu cliente. Utilize o nome de utilizador da credencial como ID do cliente OAuth. Este fluxo não utiliza um segredo do cliente.
- Os callbacks devem utilizar HTTPS ou HTTP num endereço de loopback explícito. O URL completo deve corresponder, incluindo a porta. Para o alterar, crie uma nova credencial e revogue a antiga.
- º Ligue-se a partir do seu cliente, inicie sessão como o Proprietário que criou a credencial e reveja o ecrã de consentimento. O cliente deve utilizar o S256 PKCE e o URL do recurso MCP. O consentimento pode restringir as permissões da credencial; não pode adicionar permissões.
Terminais Cloud OAuth
- º Autorização
https://app.remotegymp.com/integration/oauth/authorize- º Troca de tokens
https://app.remotegymp.com/integration/oauth/token- Metadados do servidor de autorização
https://app.remotegymp.com/.well-known/oauth-authorization-server- Metadados de recursos protegidos
https://api.remotegymp.com/.well-known/oauth-protected-resource/mcp
O OAuth utiliza nomes de campo de token padrão e tokens de atualização rotativos. O cliente deve tratar a atualização automaticamente. Os tokens de acesso duram no máximo 30 minutos. As ligações expiram após sete dias sem atualização ou 30 dias no total. A reutilização de um token de atualização antigo invalida a ligação; volte a ligar em vez de reproduzi-lo.
Ligue-se com um token ao portador
Se o seu cliente suportar um token de portador configurado, troque uma credencial habilitada para MCP no terminal do token com o público do MCP e, em seguida, coloque o token devolvido na configuração de token de portador seguro do cliente. Expira após 30 minutos. Não coloque um token no URL do servidor. Utilize o OAuth para clientes que necessitem de atualização automática.
{
"username": "<your-credential-username>",
"password": "<your-credential-secret>",
"audience": "mcp"
}º Verifique o acesso antes de trabalhar
º Peça ao cliente para listar primeiro as ferramentas disponíveis e os recursos de leitura. Comece com um pedido de leitura apenas, como listar dispositivos. Uma ferramenta em falta pode refletir permissões, âmbito ou disponibilidade. A ativação do MCP por si só não concede controlo remoto.
tools/list · get_capabilities
º A visualização do ecrã segue o consentimento do dispositivo. A entrada no ecrã precisa de uma nova captura de ecrã. Reveja as metas, as visualizações de exclusão e os custos de IA cotados antes de aprovar o trabalho. A paragem de emergência bloqueia a automatização adicional; o trabalho já em execução pode terminar.
º Desconectar ou revogar o acesso
º Desligue-se do seu cliente e revogue a credencial em Definições quando já não for necessária. A revogação interrompe os seus tokens associados e as ligações OAuth em pedidos subsequentes. Nunca partilhe a credencial entre integrações não relacionadas.