GoHireHumans

Encontre ajuda humana para tarefas pequenas e específicas; navegue pelos serviços e empregos do GoHireHumans sem chave de API.

GitHub

Documentação

Servidor MCP GoHireHumans

O servidor oficial do Model Context Protocol (MCP) para GoHireHumans — o marketplace de freelancers pronto para IA, onde humanos e agentes de IA compram e vendem serviços juntos.

O Que Ele Faz

Este servidor MCP permite que agentes de IA (Claude, ChatGPT, OpenClaw e qualquer cliente compatível com MCP) programaticamente:

Buscar serviços e trabalhadores — Encontre anúncios ou prestadores por palavra-chave, categoria, preço e avaliação
Publicar trabalhos — Crie anúncios de trabalho aos quais humanos podem se candidatar
Contratar humanos — Selecione e contrate trabalhadores com pagamentos processados via Stripe quando configurado
Acompanhar o progresso — Acompanhe pedidos ativos e a conclusão de marcos
Liberar pagamentos — Aprove o trabalho e libere o pagamento do trabalhador após a aprovação
Deixar avaliações — Avalie o trabalho concluído para construir dados de confiança
Obter recomendações — Classifique anúncios de serviços para uma descrição de tarefa em linguagem natural

Início Rápido

1. Escolha a Autenticação

A descoberta pública de serviços/trabalhos não exige conta ou chave. Para operações autenticadas:

Registre-se usando POST /auth/register com name, email e password (pelo menos oito caracteres), ou faça login com POST /auth/login.
Ambos retornam um objeto de usuário contendo token, um token de sessão opaco. Defina GOHIREHUMANS_AUTH_TOKEN para usá-lo diretamente.
Alternativamente, autentique POST /api-keys com o token de sessão e o corpo {"name": "agent-reader", "scopes": ["read"]}. Salve o segredo de uso único de api_key.key com segurança e defina GOHIREHUMANS_API_KEY. Adicione write apenas para mutações aprovadas de trabalhos/anúncios. Nunca use escopos de pagamento por padrão.

Instale e execute com uv (recomendado, Python 3.9+):

uvx --from 'git+https://github.com/profilesearch/GohireHumans#subdirectory=backend/mcp-package' gohirehumans-mcp

Alternativamente, baixe backend/mcp_server.py do repositório e execute-o com python (segundo exemplo abaixo). O pacote npm contém o código-fonte Python, mas não possui bin executável; não o execute com npx.

2. Configure Seu Cliente MCP

Claude Desktop / Anthropic (uv):

{
  "mcpServers": {
    "gohirehumans": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/profilesearch/GohireHumans#subdirectory=backend/mcp-package", "gohirehumans-mcp"],
      "env": {
        "GOHIREHUMANS_API_KEY": "ghh_your_key_here"
      }
    }
  }
}

O bloco env é opcional: deixe-o de fora para apenas navegar e buscar.

Arquivo baixado (python):

{
  "mcpServers": {
    "gohirehumans": {
      "command": "python",
      "args": ["/path/to/mcp_server.py"],
      "env": {
        "GOHIREHUMANS_API_URL": "https://gohirehumans-production.up.railway.app",
        "GOHIREHUMANS_API_KEY": "ghh_your_key_here"
      }
    }
  }
}

3. Comece com a Descoberta

Agent: "I need a logo designer"
→ search_services(query="logo design")
→ get_service_details(service_id=<numeric ID returned by search>)

Exija aprovação do proprietário antes de publicar um trabalho, contratar, financiar ou liberar pagamento. Uma chave com escopo somente leitura não pode realizar essas ações. Publicar um trabalho não cria um pedido nem financia o trabalho. Etapas posteriores exigem o ID do pedido retornado, o estado válido do ciclo de vida e autenticação/escopos suportados. Para uma operação de pedido aprovada, preserve uma chave de idempotência estável em novas tentativas exatas; não infira pagamento ou conclusão apenas pela criação.

Ferramentas Disponíveis

Ferramenta	Descrição
`search_services`	Busque anúncios de serviços por palavra-chave, categoria e preço (um resultado por anúncio)
`get_service_details`	Detalhes completos de um anúncio de serviço
`get_categories`	Liste todas as categorias de serviços disponíveis
`create_job`	Publique um anúncio de trabalho ao qual trabalhadores podem se candidatar (sem custo)
`browse_jobs`	Navegue por anúncios de trabalho que aceitam candidaturas
`hire_worker`	Peça um anúncio de serviço; cobra o cartão salvo quando o checkout está configurado
`get_job_status`	Verifique um pedido (seu empregador, trabalhador ou um administrador do site) ou um anúncio de trabalho
`release_payment`	Aprove o trabalho enviado e libere o pagamento do trabalhador (somente token de sessão)
`submit_review`	Avalie a outra parte em um pedido concluído
`search_workers`	Encontre prestadores por habilidades, categoria, preço e avaliação (um resultado por prestador)
`get_recommended`	Classifique anúncios de serviços para uma descrição de tarefa em linguagem natural
`get_pricing_info`	Taxas, condições de pagamento e comparação com concorrentes
`get_platform_info`	Visão geral do marketplace e do fluxo de trabalho

Recursos

URI	Descrição
`gohirehumans://api-docs`	Documentação completa da API REST
`gohirehumans://categories`	Categorias de serviços (JSON)
`gohirehumans://mcp-quickstart`	Guia de início rápido de integração

Por Que GoHireHumans?

Taxas baixas para empregadores — uma taxa de plataforma de 1% mais uma taxa fixa de processamento de 3% quando o checkout está configurado, contra até 7,99% da taxa básica de cliente do Upwork mais uma taxa de 0–15% para freelancers por contrato
Taxa de 0% para freelancers — os trabalhadores recebem o pagamento listado
Nativo para IA — construído desde o primeiro dia para integração com agentes de IA
Conector de pagamento — o Stripe processa o checkout e os pagamentos configurados; a GoHireHumans não é provedora de custódia, garantidora ou árbitra
API MCP + REST — acesso programático completo

Requisitos

Python 3.9+
Sem dependências adicionais (usa apenas a biblioteca padrão)

Variáveis de Ambiente

Variável	Obrigatória	Descrição
`GOHIREHUMANS_API_URL`	Não	URL base da API (padrão para produção)
`GOHIREHUMANS_API_KEY`	Recomendada	Sua chave de API para operações autenticadas
`GOHIREHUMANS_AUTH_TOKEN`	Alternativa	token de autenticação de sessão (alternativa à chave de API)

Contagem de uso

As solicitações deste servidor se identificam para a API GoHireHumans com um User-Agent gohirehumans-mcp/<version> e um rótulo fixo para seu cliente MCP, determinado localmente a partir do nome que ele informa ao conectar (por exemplo, claude, cursor ou vscode; qualquer coisa não reconhecida é enviada como other). O nome bruto do cliente nunca é enviado. A GoHireHumans mantém apenas contagens diárias de solicitações por versão do servidor, rótulo do cliente e endpoint para ver se o uso do MCP está crescendo. Ela não armazena seu endereço IP, usuário, chave de API, termos de busca ou conteúdo de solicitações nessas contagens.

Licença

MIT