RemoteGymp · API v1

Conecte um assistente de IA

Use um cliente MCP que suporte HTTP Streamable e OAuth pré-registrado com PKCE ou um token de portador configurado. O suporte ao cliente varia; o registro automático do cliente não está disponível.

URL do servidor MCP

https://api.remotegymp.com/mcp

Para auto-hospedado, use o mesmo caminho MCP no endereço HTTPS público da sua instalação. Seu cliente deve ser capaz de alcançá-lo. O endereço da nuvem não faz proxy de solicitações para sua instalação.

Conecte-se com OAuth

  1. Em Configurações, crie uma credencial com MCP habilitado e apenas as permissões que o assistente precisa. Registre o URL de retorno de chamada exato fornecido pelo seu cliente. Use o nome de usuário da credencial como ID do cliente OAuth. Este fluxo não usa um segredo do cliente.
  2. Os retornos de chamada devem usar HTTPS ou HTTP em um endereço de loopback explícito. O URL completo deve corresponder, incluindo a porta. Para alterá-lo, crie uma nova credencial e revogue a antiga.
  3. Conecte-se a partir do seu cliente, faça login como o Proprietário que criou a credencial e revise a tela de consentimento. O cliente deve usar S256 PKCE e a URL do recurso MCP. O consentimento pode restringir as permissões da credencial; ele 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

OAuth usa 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 conexõ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 conexão; reconecte em vez de reproduzi-lo.

Conecte-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 retornado na configuração de token de portador seguro do cliente. Ele expira após 30 minutos. Não coloque um token na URL do servidor. Use o OAuth para clientes que precisam de atualização automática.

{
  "username": "<your-credential-username>",
  "password": "<your-credential-secret>",
  "audience": "mcp"
}

Autenticação →

Verifique o acesso antes de trabalhar

Peça ao cliente para listar primeiro as ferramentas disponíveis e os recursos de leitura. Comece com uma solicitação somente leitura, como listar dispositivos. Uma ferramenta ausente pode refletir permissões, escopo ou disponibilidade. A ativação do MCP por si só não concede controle remoto.

tools/list · get_capabilities

A visualização da tela segue o consentimento do dispositivo. A entrada na tela precisa de uma nova captura de tela. Revise metas, visualizações de exclusão e custos de IA cotados antes de aprovar o trabalho. A parada de emergência bloqueia a automação adicional; o trabalho já em execução pode terminar.

Desconectar ou revogar acesso

Desconecte-se do seu cliente e revogue a credencial em Configurações quando ela não for mais necessária. A revogação interrompe seus tokens associados e conexões OAuth em solicitações subsequentes. Nunca compartilhe a credencial entre integrações não relacionadas.

Revisão de conteúdo 3f225a253 · OpenAPI SHA-256: b12c42306a89