ACESSO PARA AGENTES

Seu agente. Seus links.Um workspace.

Conecte um cliente MCP HTTP com um token do workspace. Gerencie links, Pages e dados de campanha com as permissões que você conceder.

Conectar meu agente Começar grátis

Um workspace Free basta para começar. Você emite o token e escolhe as permissões.

MCP HTTP / WORKSPACE

Endpoint para o seu cliente

https://urlpivot.app/api/agent/mcp

Authorization: Bearer upv_…

Emita um token em Agentes IA → Acesso de agentes. O token pertence a um workspace e pode ser revogado.

Escolher a configuração do cliente

SUA PRIMEIRA CONEXÃO

Conecte em três passos

A pessoa configura o acesso uma vez. O agente atua dentro do workspace, do plano e das permissões escolhidos.

01
Crie o workspace
Entre. O plano Free basta. O token é de um workspace, não da conta inteira.
02
Emita um token
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.
03
Cole o endpoint
Qualquer cliente MCP HTTP. Authorization: Bearer upv_… A mesma URL para Hermes, Codex, Grok Custom MCP e APIs. OAuth 2.1 de usuário no ChatGPT não está implementado.

Abrir meu workspace

Copie um config e troque o token

Escolha seu cliente abaixo. Substitua o token de exemplo pelo token do workspace e mantenha o segredo na configuração privada do cliente.

Qualquer cliente MCP HTTP

{
  "url": "https://urlpivot.app/api/agent/mcp",
  "transport": "http",
  "headers": {
    "Authorization": "Bearer upv_YOUR_TOKEN"
  }
}

Codex

[mcp_servers.urlpivot]
url = "https://urlpivot.app/api/agent/mcp"
http_headers = { Authorization = "Bearer upv_YOUR_TOKEN" }

Hermes / OpenClaw

mcpServers:
  urlpivot:
    url: https://urlpivot.app/api/agent/mcp
    headers:
      Authorization: "Bearer upv_YOUR_TOKEN"

Grok Custom MCP

{
  "url": "https://urlpivot.app/api/agent/mcp",
  "transport": "http",
  "headers": {
    "Authorization": "Bearer upv_YOUR_TOKEN"
  }
}

O Grok Custom MCP pode usar o mesmo endpoint MCP HTTP e o cabeçalho Bearer. O diálogo de autorização do Grok não foi verificado neste produto. Se esse diálogo não enviar Authorization, use Hermes, Codex ou qualquer cliente MCP HTTP que aceite cabeçalhos.

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. 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.

ChatGPT

A autorização de usuário no ChatGPT exige OAuth 2.1, que o URLPivot ainda não implementou. Não há botão de conexão do ChatGPT. Um plugin do ChatGPT não é necessário para clientes MCP e não substitui OAuth. Use Hermes, Codex, Grok Custom MCP ou qualquer cliente MCP HTTP com um token Bearer.

Android beta nativo

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.

Compatibilidade dos clientes e detalhes de acesso

É o mesmo protocolo para Hermes, Codex, Grok Custom MCP e APIs. Não é selo de integração certificada. OAuth 2.1 de usuário no ChatGPT não está implementado. A Bitly já tem MCP; a diferença aqui é continuidade do destino, não ser o primeiro.

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.

SEU PRÓXIMO FLUXO

Dê uma missão clara ao seu agente.

Conecte seu cliente MCP, escolha uma tarefa e copie as instruções. O agente conectado executa com as permissões que você escolher.

01 / PREPARAR

O que sua Page precisa fazer?

Marca ou projetoPúblico e objetivo

Use o perfil de conexão “Preparar rascunhos de Pages”. Revise o resultado no editor da Page.

Criação de rascunhos e publicação têm permissões separadas.

02 / ENVIAR AO SEU AGENTE

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.

Explorar as 27 ferramentas MCP implementadas

Catálogo de referência. Sua conexão expõe só as ferramentas permitidas pelo token, plano e backend. Consulte tools/list para conferir.

Buscar ferramenta ou permissão

set_page_avatarpages:write
set_page_coverpages:write
set_page_thumbnailpages:write
create_domaindomains:write
reconcile_domaindomains:write
list_linkslinks:read
get_linklinks:read
create_linklinks:create
update_destinationlinks:update_destination
update_linklinks:update
set_link_statuslinks:status
list_foldersfolders:read
save_folderfolders:write
generate_qrqr:read
list_pagespages:read
get_pagepages:read
create_pagepages:write
update_pagepages:write
publish_pagepages:write · pages:publish
unpublish_pagepages:write · pages:publish
duplicate_pagepages:write
get_analyticsanalytics:read
list_auditaudit:read
get_workspace_contextworkspace:read
get_workspace_domainsdomains:read
get_workspace_billing_accessbilling:read
update_page_presentationpages:write

PERMISSÕES QUE VOCÊ CONTROLA

Links, Pages e dados. Você escolhe as permissões.

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.

Links

Liste, crie, edite, pause e reative sem trocar o endereço permanente.

Pastas

Organize este workspace com pastas e mova links entre elas.

QR

Gere códigos QR em PNG para os links existentes.

Pages

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.

Analytics

Consulte cliques agregados, não registros individuais de visitantes.

Workspace

Consulte limites do plano e histórico, sem acesso à conta inteira nem ao admin.

LIMITES DO ACESSOO token nunca faz isso

Pagamentos ou alteração de plano
Exclusão ou admin
Outros workspaces
Publicação de DNS ou login na Cloudflare
OAuth do Claude.ai
OAuth do ChatGPT

O que o agente chama

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.

MCPhttps://urlpivot.app/api/agent/mcp
Documento para máquinahttps://urlpivot.app/llms.txt
JSON de descobertahttps://urlpivot.app/.well-known/mcp.json

Caminho em runtime: /api/agent/mcp · https://urlpivot.app

Ler llms.txt

DOMÍNIO DA MARCASeu domínio, com instruções claras de DNS e certificado.

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.

Em Domínios, adicione o hostname exato e escolha validação HTTP ou TXT para a nova conexão.
No DNS, crie um CNAME para domains.urlpivot.app.
Na validação TXT, publique todas as instruções TXT recebidas. Use somente DNS, salvo orientação do provedor para um proxy compatível.
Use Verificar ativação ou reconcile_domain para atualizar o estado e as instruções TXT pendentes. Use o link da plataforma até DNS e TLS ficarem ativos.

OAuth one-click da Cloudflare ainda não existe neste produto. Não entregue senha da Cloudflare a um agente.

Comece pelo seu workspace.