Servidor MCP

Setup com um prompt a partir de Cursor, Claude Code, Codex ou qualquer cliente MCP.

O servidor MCP da rendfly permite que um agente de código configure monitoramento sem abrir o dashboard. Ele é uma camada de setup: cria projetos, escreve system messages, configura conexões de provider e emite chaves de projeto. O tráfego de produção ainda passa pelo caminho de ingestão configurado; hoje, isso significa proxy mode.

O dashboard também inclui uma página autenticada de setup em /app/mcp para gerar tokens MCP de curta duração e copiar snippets de configuração para Claude Code, Cursor ou Codex. Tokens são mostrados apenas na sessão da página e não devem ser commitados em configs de repositório.

Endpoint

Use o endpoint HTTP MCP remoto:

https://api.rendfly.com/mcp

Para desenvolvimento local:

http://localhost:8080/mcp

O endpoint aceita tokens MCP de curta duração emitidos a partir de uma sessão autenticada SuperTokens da rendfly. Envie o token em um header Authorization: Bearer ... para clientes MCP locais. Ferramentas mutáveis de setup exigem acesso owner ou admin ao workspace. Não commite tokens nem chaves de provider em configs MCP do repositório.

O endpoint de metadados do recurso protegido está disponível em:

https://api.rendfly.com/.well-known/oauth-protected-resource/mcp

Clientes MCP precisam enviar Bearer tokens no header Authorization em toda requisição. Tokens em query string são rejeitados.

Token de acesso

O caminho mais fácil é App -> MCP -> Gerar token. Para scripts, crie um token MCP de curta duração a partir de uma sessão autenticada da rendfly:

export RENDFLY_ACCESS_TOKEN="$(
  curl -sS https://api.rendfly.com/api/mcp/token 
    -X POST 
    -H "Content-Type: application/json" 
    -b "${RENDFLY_SESSION_COOKIE}" 
    -d '{"ttl_seconds":900}' | jq -r .access_token
)"

O token é assinado por chaves OpenID/JWT do SuperTokens, limitado ao escopo mcp:setup, preso à audiência rendfly:mcp e expira em no máximo uma hora. Use o menor TTL que funcione para a sessão de setup.

Claude Code

export RENDFLY_ACCESS_TOKEN="..."
claude mcp add --transport http rendfly https://api.rendfly.com/mcp 
  --header "Authorization: Bearer ${RENDFLY_ACCESS_TOKEN}"
claude mcp list

Use --scope local ou o escopo local padrão quando houver credenciais envolvidas.

Cursor

Crie ~/.cursor/mcp.json ou .cursor/mcp.json para um setup local do projeto:

{
  "mcpServers": {
    "rendfly": {
      "url": "https://api.rendfly.com/mcp",
      "headers": {
        "Authorization": "Bearer ${RENDFLY_ACCESS_TOKEN}"
      }
    }
  }
}

Reinicie o Cursor depois de alterar o arquivo.

Codex

export RENDFLY_ACCESS_TOKEN="..."
codex mcp add rendfly --url https://api.rendfly.com/mcp 
  --bearer-token-env-var RENDFLY_ACCESS_TOKEN
codex mcp list

Equivalente em ~/.codex/config.toml:

[mcp_servers.rendfly]
url = "https://api.rendfly.com/mcp"
bearer_token_env_var = "RENDFLY_ACCESS_TOKEN"

Ferramentas

  • rendfly_create_project — cria um projeto em um workspace ou retorna o projeto existente com o mesmo nome para setup repetível.
  • rendfly_get_system_message — lê a system message atual e as regras extraídas.
  • rendfly_set_system_message — cria ou reutiliza uma versão de system message; corpos idênticos são idempotentes por SHA-256.
  • rendfly_configure_provider — armazena uma chave de provider OpenAI ou Anthropic criptografada em repouso. A chave nunca é retornada.
  • rendfly_disconnect_provider — remove uma conexão de provider.
  • rendfly_mint_project_key — emite uma chave de projeto uma vez. Chamadas repetidas com o mesmo nome retornam apenas metadados, não o segredo.
  • rendfly_revoke_project_key — revoga uma chave de projeto pelo ID da chave.

O endpoint Streamable HTTP espera uma mensagem JSON-RPC por POST, com Accept: application/json, text/event-stream. Batches JSON-RPC são rejeitados. Streams SSE GET standalone retornam 405, porque a rendfly não envia requests MCP iniciados pelo servidor atualmente.

Prompt de exemplo

Configure monitoramento da rendfly para este projeto. Use o workspace ..., crie um projeto chamado Support Bot, leia a system message de prompts/system.md, configure OpenAI com minha chave de provider e emita uma chave de projeto chamada local setup.

O servidor MCP faz apenas o setup do lado da rendfly. Seu agente ainda precisa atualizar o código da aplicação para enviar tráfego LLM de produção pelo endpoint proxy da rendfly.

Relacionado

  • Proxy mode — o caminho de ingestão de produção que o setup MCP geralmente configura
Updated 2026-05-20