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/mcpO 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/mcpehttps://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/tokencomapplication/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/mcpCursor
{
"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).