Openhandle

npx add-mcp 'https://api.openhandle.dev/mcp'

Dados sociais para o seu agente. Um servidor, cada endpoint é uma ferramenta.

O Openhandle dá ao seu agente acesso a Instagram, TikTok, X e Reddit. Cada endpoint da API vira uma ferramenta.

URL do servidor: https://api.openhandle.dev/mcp (HTTP Streamable)

Conectar

Claude

https://api.openhandle.dev/mcp

1. Adicione um conector personalizado. Abra Configurações, depois Conectores, depois Adicionar conector personalizado. Cole a URL do servidor.
2. Aprove no navegador. O Openhandle abre em uma aba e pede que você aprove a conexão. Escolha Teste ou Produção nessa tela.
3. Peça dados sociais. As ferramentas aparecem no chat. Peça em palavras simples e o agente escolhe a certa.

ChatGPT

https://api.openhandle.dev/mcp

1. Adicione um conector. Abra Configurações, depois Conectores, depois Criar. Cole a URL do servidor e salve.
2. Aprove no navegador. O Openhandle abre em uma aba e pede que você aprove a conexão. Escolha Teste ou Produção nessa tela.
3. Peça dados sociais. As ferramentas aparecem no chat. Peça em palavras simples e o agente escolhe a certa.

Claude Code

claude mcp add --transport http openhandle https://api.openhandle.dev/mcp

1. Execute um comando. Isso registra o servidor para o projeto atual.
2. Entre uma vez. Digite /mcp no Claude Code e escolha openhandle. Seu navegador abre, você aprova e escolhe Teste ou Produção. Configurações sem interface gráfica podem passar uma chave de API com --header "Authorization: Bearer $OPENHANDLE_TEST_KEY" em vez disso.
3. Peça dados sociais. As ferramentas aparecem no chat. Peça em palavras simples e o agente escolhe a certa.

Cursor

{
  "mcpServers": {
    "openhandle": {
      "url": "https://api.openhandle.dev/mcp"
    }
  }
}

1. Adicione o servidor ao mcp.json. Crie ou edite .cursor/mcp.json no seu projeto e cole isso.
2. Entre quando o Cursor pedir. O Cursor mostra um prompt de login ao lado do servidor. Aprove no navegador e escolha Teste ou Produção.
3. Peça dados sociais. As ferramentas aparecem no chat. Peça em palavras simples e o agente escolhe a certa.

VS Code

{
  "servers": {
    "openhandle": {
      "type": "http",
      "url": "https://api.openhandle.dev/mcp"
    }
  }
}

1. Adicione o servidor ao mcp.json. Crie ou edite .vscode/mcp.json no seu projeto e cole isso.
2. Inicie e entre. Clique em Iniciar acima da entrada do servidor. O VS Code abre o navegador, você aprova e escolhe Teste ou Produção.
3. Peça dados sociais. As ferramentas aparecem no chat. Peça em palavras simples e o agente escolhe a certa.

Windsurf

{
  "mcpServers": {
    "openhandle": {
      "serverUrl": "https://api.openhandle.dev/mcp"
    }
  }
}

1. Adicione o servidor ao mcp_config.json. Abra as configurações de MCP no Windsurf, edite o arquivo de configuração e cole isso.
2. Entre quando for pedido. O Windsurf abre o navegador para o login. Aprove e escolha Teste ou Produção.
3. Peça dados sociais. As ferramentas aparecem no chat. Peça em palavras simples e o agente escolhe a certa.

Experimente este prompt primeiro: Encontre um perfil público do Instagram nos dados de teste e mostre-me o número de seguidores e as três últimas postagens.

A tela de aprovação cria uma chave de API com o nome do cliente, por exemplo Claude (MCP). Desconecte um cliente em Configurações, servidor MCP no painel. Isso revoga a chave e todos os tokens de uma vez.

Ferramentas

Plataforma	Ferramentas	Exemplos
Instagram	43	instagram_get_profile, instagram_list_profile_posts, instagram_list_post_comments
TikTok	28	tiktok_get_profile, tiktok_search_posts, tiktok_list_trending_posts
X	15	twitter_get_profile, twitter_list_followers, twitter_search_posts

• find_test_data: Encontre entradas sintéticas estáveis por plataforma, operação ou característica. Sem medição.
• get_test_data: Obtenha uma entrada de catálogo sintética pelo seu ID estável. Sem medição.

Cada resultado carrega os mesmos metadados, para que seu agente possa informar quanto uma chamada custou. Campos: environment, requestId, actualCharge, liveEquivalentPrice, datasetVersion.

Quanto custa

• Sem margem de MCP. Uma chamada de ferramenta custa o mesmo que a chamada REST correspondente. Não há cobrança extra por MCP.
• Respostas mais antigas custam menos. Acertos de cache custam $0.0005 em 24 horas e $0.0001 em 7 dias. Um acerto de cache de 30 dias é gratuito.
• Requisições com falha são gratuitas. Erros do provedor, nossos erros, entrada inválida e limites de taxa não custam nada.
• Teste é sempre gratuito. Toda ferramenta funciona com dados sintéticos em Teste. A cobrança real é sempre zero.

Taxas: https://openhandle.dev/pricing.md

Detalhes de OAuth

Documento	URL
Metadados de recurso protegido	https://api.openhandle.dev/.well-known/oauth-protected-resource/mcp
Metadados do servidor de autorização	https://api.openhandle.dev/.well-known/oauth-authorization-server
Registro dinâmico de cliente	https://api.openhandle.dev/oauth/register
Autorização	https://api.openhandle.dev/oauth/authorize
Token	https://api.openhandle.dev/oauth/token
Revogação	https://api.openhandle.dev/oauth/revoke

• Tipos de concessão: authorization_code com PKCE (S256), refresh_token
• Escopo: mcp
• Token de acesso: Dura 1 hora
• Token de atualização: Rotaciona a cada uso, dura 30 dias
• Indicador de recurso: resource=https://api.openhandle.dev/mcp

FAQ

Funciona com ChatGPT?

Sim. Qualquer cliente que fale MCP remoto via HTTP Streamable funciona. Cole a URL do servidor nas configurações do conector, aprove no navegador e as ferramentas aparecem no chat.

Preciso de uma configuração de ambiente?

Não. A credencial escolhe Teste ou Produção. Com OAuth, você escolhe na tela de aprovação. Com uma chave de API, o prefixo da chave decide. Não há argumento de ambiente, cabeçalho ou configuração.

Um script pode usar sem OAuth?

Sim. Envie uma chave de API como token de portador no cabeçalho Authorization. Chaves de teste começam com oh_test_ e nunca são cobradas.

A lista de ferramentas é a mesma da API REST?

Sim. Cada endpoint público é uma ferramenta. O nome da ferramenta vem do ID da operação, como instagram_get_profile. Entradas e respostas correspondem à API REST.

Onde vejo o que meu agente gastou?

No painel, em Histórico de requisições. Chamadas MCP aparecem com canal mcp. Cada linha tem a ferramenta, o ambiente e a cobrança.

Docs: https://openhandle.dev/docs/mcp.md · Teste com MCP: https://openhandle.dev/docs/test-environment/mcp.md