ACESSO PARA AGENTES
Conecte um cliente MCP HTTP com um token do workspace. Gerencie links, Pages e dados de campanha com as permissões que você conceder.
Um workspace Free basta para começar. Você emite o token e escolhe as permissões.
SUA PRIMEIRA CONEXÃO
A pessoa configura o acesso uma vez. O agente atua dentro do workspace, do plano e das permissões escolhidos.
Entre. O plano Free basta. O token é de um workspace, não da conta inteira.
Agentes IA → Acesso de agentes. Para uma nova conexão escolha Preparar rascunhos de Pages, Criar links e consultar métricas, Leitura somente ou Personalizado. Revise as permissões selecionadas; publicação é separada. Tokens existentes não mudam. Dê um nome, copie o segredo uma vez, revogue quando quiser. Nunca coloque o segredo em URL ou QR code.
Use Authorization: Bearer upv_… no Hermes, Codex ou cliente MCP HTTP. O ChatGPT usa OAuth 2.1: autorize o workspace e as permissões no URLPivot, sem emitir um token manual.
Escolha seu cliente abaixo. Substitua o token de exemplo pelo token do workspace e mantenha o segredo na configuração privada do cliente.
O URLPivot oferece OAuth 2.1 para o ChatGPT. Quando sua conta ChatGPT disponibilizar conexões MCP personalizadas, adicione este endpoint e autorize o workspace e as permissões no URLPivot. Esse fluxo dispensa token manual. A disponibilidade no diretório depende da revisão da OpenAI e da sua conta.
Copie o exemplo para o aplicativo que você usa.
[mcp_servers.urlpivot]
url = "https://urlpivot.app/api/agent/mcp"
http_headers = { Authorization = "Bearer upv_YOUR_TOKEN" }Substitua upv_YOUR_TOKEN somente na configuração privada do cliente. Os exemplos nunca incluem seu segredo real. Nunca embuta o segredo do token em URL, QR code, link de instalação, prompt ou snippet de exibição. Cole-o só no cabeçalho Authorization do cliente.
Hermes e Codex usam config MCP HTTP nativa com Authorization: Bearer. Não são integrações certificadas. Troque upv_YOUR_TOKEN pelo segredo exibido uma vez; nunca coloque o segredo em uma URL. As APIs REST e MCP HTTP usam o mesmo token Bearer do workspace. Plugin não é necessário para clientes MCP. OAuth não é plugin.
Um app Android beta nativo pode usar um token de workspace emitido com o perfil que você escolher para uma nova conexão. Um APK ainda não está disponível. Não coloque o token em URL de instalação, QR code, prompt ou snippet de exibição.
Hermes, Codex e clientes compatíveis, como Grok Custom MCP, usam token Bearer do workspace. O ChatGPT usa OAuth 2.1 quando sua conta disponibiliza conexões MCP personalizadas. A disponibilidade no diretório depende da revisão da OpenAI. Compatibilidade de cliente não é selo de certificação.
Esta seleção vale só para uma nova conexão. Tokens existentes mantêm as permissões atuais e não são ampliados. Um app Android beta nativo pode usar um token de workspace emitido com o perfil que você escolher para uma nova conexão. Um APK ainda não está disponível. Não coloque o token em URL de instalação, QR code, prompt ou snippet de exibição.
Conecte seu cliente MCP, escolha uma tarefa e copie as instruções. O agente conectado executa com as permissões que você escolher.
Use o perfil de conexão “Preparar rascunhos de Pages”. Revise o resultado no editor da Page.
Primeiro leia urlpivot://capabilities, tools/list e get_workspace_context. Confirme o workspace conectado, seus limites e as permissões concedidas. Explique permissões ausentes antes de alterar registros. Pergunte qual é a marca, o público e o objetivo. Leia list_pages e list_links. Sugira título, slug, descrição, nicho suportado, direção visual e links ativos do workspace; peça meu aceite do briefing. Depois use create_page com creationId UUID estável e status draft. Preserve esse ID; se a resposta for incerta, consulte get_page com o mesmo ID antes de tentar novamente. Ajuste os campos de apresentação suportados com o expectedUpdatedAt exato. Leia a Page salva e devolva o link do editor para revisão. Mantenha-a privada. Não publique nem altere uma Page existente publicada. Seções adicionais e envio de fundo podem ser concluídos no editor.
Cole no cliente conectado. Este painel prepara instruções; não executa um modelo nem consome crédito de IA.
Catálogo de referência. Sua conexão expõe só as ferramentas permitidas pelo token, plano e backend. Consulte tools/list para conferir.
set_page_avatarpages:writeset_page_coverpages:writeset_page_thumbnailpages:writecreate_domaindomains:writereconcile_domaindomains:writelist_linkslinks:readget_linklinks:readcreate_linklinks:createupdate_destinationlinks:update_destinationupdate_linklinks:updateset_link_statuslinks:statuslist_foldersfolders:readsave_folderfolders:writegenerate_qrqr:readlist_pagespages:readget_pagepages:readcreate_pagepages:writeupdate_pagepages:writepublish_pagepages:write · pages:publishunpublish_pagepages:write · pages:publishduplicate_pagepages:writeget_analyticsanalytics:readlist_auditaudit:readget_workspace_contextworkspace:readget_workspace_domainsdomains:readget_workspace_billing_accessbilling:readupdate_page_presentationpages:writePERMISSÕES QUE VOCÊ CONTROLA
Leitura somente, operação de links ou acesso personalizado: conceda o que a tarefa precisa. Publicar Pages e gerenciar domínios exigem permissões próprias.
Liste, crie, edite, pause e reative sem trocar o endereço permanente.
Organize este workspace com pastas e mova links entre elas.
Gere códigos QR em PNG para os links existentes.
Crie e personalize Pages, duplique Pages com imagens independentes e envie avatar/capa/miniatura de link selecionado com set_page_avatar, set_page_cover e set_page_thumbnail (PNG, JPEG ou WebP, até 45.000 bytes). Publicar e editar Pages publicadas exigem permissão separada.
Consulte cliques agregados, não registros individuais de visitantes.
Consulte limites do plano e histórico, sem acesso à conta inteira nem ao admin.
O endpoint, a documentação para máquina e o contrato de descoberta são públicos. A conexão aos dados do workspace exige seu token.
https://urlpivot.app/api/agent/mcphttps://urlpivot.app/llms.txthttps://urlpivot.app/.well-known/mcp.jsonCaminho em runtime: /api/agent/mcp · https://urlpivot.app
O Pro conecta um hostname exato, como go.suaempresa.com. Raiz e curinga ficam fora. Com permissão explícita de domínio, o agente cadastra seu subdomínio, retorna o CNAME e solicita verificação ao provedor. Ele não entra na Cloudflare nem publica DNS por você. Provedor desativado ou simulado não comprova um domínio ativo.
A tela Domínios oferece conexão assistida com a Cloudflare ou configuração manual de DNS. Esses fluxos são separados das permissões MCP. Nunca entregue sua senha Cloudflare a um agente.