nestly.Seus aplicativos + seu mundo
NestlyBot

Conectar um cliente MCP.

Claude, Cursor, Grok e outros clientes usam o mesmo servidor da sua conta. A autorização acontece no Nestly, com PKCE, e você revoga quando quiser.

Endpoint e transporte

Configure o cliente com este endereço. O transporte é HTTP sem sessão (Streamable HTTP): envie JSON-RPC em POST. Depois da autenticação, GET responde 405; não há canal SSE.

https://nestly.bot/api/mcp

O mesmo handler atende https://nestly.bot/mcp quando o pedido chega ao Nestly. A descoberta anuncia https://nestly.bot/api/mcp, o endereço que o aplicativo confirma. Um token vale só para o recurso exato em que foi emitido.

OAuth e registro dinâmico

Authorization code com PKCE S256 obrigatório, state e códigos de curta duração. O cliente é público (token_endpoint_auth_method: none) e se registra sozinho (RFC 7591).

  • Metadados do servidor: https://nestly.bot/.well-known/oauth-authorization-server
  • Metadados do recurso: https://nestly.bot/.well-known/oauth-protected-resource
  • Metadados deste endpoint: https://nestly.bot/.well-known/oauth-protected-resource/api/mcp
  • Dica de descoberta: https://nestly.bot/.well-known/mcp e https://nestly.bot/llms.txt
  • Registro: POST https://nestly.bot/oauth/register
  • Autorização: GET https://nestly.bot/oauth/authorize
  • Token: POST https://nestly.bot/oauth/token com application/x-www-form-urlencoded

Os escopos são nestly:read e nestly:write. A tela de consentimento mostra o nome enviado no registro, o host do endereço de retorno e os escopos. Confira o host antes de autorizar: o nome do cliente é o que o software declarou.

Qualquer redirect_uri https público, sem usuário, consulta ou fragmento, pode ser registrado. Em /authorize ele precisa ser exatamente um dos URIs registrados. Loopback (http://127.0.0.1, http://localhost ou http://[::1], porta de 1 a 65535) pode mudar só a porta, conforme a RFC 8252. A troca do token continua exigindo o URI exato usado na autorização. MCP_ALLOWED_REDIRECT_URIS, se estiver definida, restringe os URIs https a essa lista. MCP_DENIED_REDIRECT_URIS recusa URIs exatos. Sem as duas, não há lista obrigatória.

Ferramentas

Leitura: guia, governo, capacidades, conexões, vida do Space, feed, Spaces, agentes, Things, execução de plano e lista de execuções.

Escrita, só com nestly:write e pedido seu: criar e editar Spaces, agentes, Things, planos, tarefas e contratos; arquivar; enviar contexto ao NestlyBot. Enviar contexto não executa o texto. Propor tarefa não agenda trabalho.

Limites

  • Ferramentas MCP: 1.000 chamadas por conta por dia, salvo um limite maior configurado no servidor.
  • Registro OAuth: 1.000 por dia. Autorização: 100 por cliente por dia.
  • Admissão: no máximo 2 chamadas MCP ao mesmo tempo no processo, 1 por credencial. Se a fila enche, a resposta é 429 com Retry-After: 2.
  • Acesso dura 1 hora. O refresh gira, dura 30 dias e não amplia escopos.

Claude Code

claude mcp add --transport http --scope user nestly https://nestly.bot/api/mcp

Cursor

{
  "mcpServers": {
    "nestly": { "url": "https://nestly.bot/api/mcp" }
  }
}

Cliente genérico

Leia os metadados, registre o redirect_uri exato do cliente, autorize com code_challenge_method=S256 e troque o código em /oauth/token. Depois:

POST https://nestly.bot/api/mcp
Authorization: Bearer <access_token>
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

A conta Nestly é por convite. Se o email ainda não for membro, o link de entrada não é enviado e a resposta não diz se o endereço existe. Peça um convite ou entre na lista de espera. Depois de autorizar, peça uma leitura real (get_capabilities e list_spaces).

Conexões e revogação