Hubity

npx add-mcp 'https://hubity.io/api/mcp'

Servidor MCP Hubity: conecte qualquer assistente

A tarefa mais comum é o faturamento do mês: um assistente pré-visualiza cada fatura a partir de horas aprovadas, despesas, retentores e progresso de contratos, e então as rascunha para uma pessoa revisar e enviar no Hubity. A leitura exige seu login e aprovação e segue seu perfil; as três ações que alteram dados precisam de acesso de escrita que você aprova.

Gratuito no Starter para até 3 pessoas. Sem necessidade de cartão.

Visão geral

O Hubity executa um servidor remoto Model Context Protocol (MCP) em https://hubity.io/api/mcp. Um assistente conectado pode faturar o mês (pré-visualizar cada fatura e depois rascunhá-las para revisão), ler projetos, tarefas, pessoas, clientes e negócios, propostas e faturas, reuniões e folgas, e pesquisar a base de conhecimento da empresa, sempre limitado ao que a pessoa conectada pode ver.

Três ferramentas alteram dados: log_time_entry registra horas, create_invoice_from_proposal transforma uma proposta aceita em fatura rascunho, e create_month_invoice_drafts rascunha as faturas do mês para revisão. Nenhuma delas envia nada para um cliente. Todas as três precisam de acesso de escrita (mcp:write), que é concedido somente quando a pessoa que conecta aprova na tela de consentimento do Hubity. Todas as outras ferramentas apenas leem.

O servidor implementa MCP 2026-07-28 sobre HTTP Streamable (requisições sem estado, server/discover) e ainda aceita clientes que abrem com o handshake 2025-11-25 initialize. OAuth 2.1 com PKCE é o login principal, e toda conexão mostra uma tela de consentimento do Hubity listando exatamente o que o assistente pode fazer. Códigos de acesso somente leitura, criados no The Hub em Integrações, funcionam para clientes de linha de comando e scripts.

Conectando

Clientes suportados: Claude, Claude Desktop, Claude Code, ChatGPT, Microsoft Copilot (via Copilot Studio), Grok, Gemini, Cursor, VS Code e Windsurf. Cada um faz seu login no Hubity com OAuth e mostra a tela de consentimento, onde você escolhe Permitir acesso ou Negar.

Claude e Claude Desktop

No Claude, abra Customize → Connectors → Add → Add custom connector e cole https://hubity.io/api/mcp (no Team e Enterprise, um proprietário adiciona em Organization settings → Connectors primeiro). O Claude Desktop usa os mesmos conectores. O Claude faz seu login no Hubity e mostra a tela de consentimento; permita o acesso e as ferramentas aparecem.

Para usar um código de acesso somente leitura no Claude Desktop, adicione uma entrada de ponte em claude_desktop_config.json (requer Node.js):

{
  "mcpServers": {
    "hubity": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://hubity.io/api/mcp",
               "--header", "Authorization: Bearer <access code>"]
    }
  }
}

Claude Code

O Claude Code (o CLI) registra servidores com um único comando. Para conectar com login pelo navegador (sem gerenciar códigos):

claude mcp add --transport http hubity https://hubity.io/api/mcp

Depois execute /mcp dentro do Claude Code e aprove o login no Hubity. Para usar um código de acesso somente leitura (útil para scripts e CI), passe-o como cabeçalho:

claude mcp add --transport http hubity https://hubity.io/api/mcp \
 --header "Authorization: Bearer <access code>"

Adicione --scope user para disponibilizar a conexão em todos os seus projetos, ou envie um .mcp.json de projeto para compartilhar com sua equipe. Verifique com claude mcp list.

ChatGPT

1. Nas configurações do ChatGPT, ative o Modo desenvolvedor. Em um workspace Business, Enterprise ou Edu, um administrador pode precisar permitir primeiro.
2. Crie um novo aplicativo ou conector, nomeie como Hubity, cole https://hubity.io/api/mcp como URL do servidor MCP e escolha OAuth para autenticação.
3. O ChatGPT faz seu login no Hubity e mostra a tela de consentimento. Permita o acesso e as ferramentas aparecem nos seus chats.

O ChatGPT conecta com acesso de leitura primeiro. Na primeira vez que você pedir para registrar horas ou rascunhar uma fatura, o Hubity pede que você permita acesso de escrita; aprove na tela de consentimento e a ação é executada.

Microsoft Copilot

No Copilot Studio, abra o agente e depois Tools → Add a tool → New tool → Model Context Protocol. Nomeie como Hubity, cole https://hubity.io/api/mcp como URL do servidor e escolha OAuth 2.0 com Descoberta dinâmica. Crie uma nova conexão, faça login no Hubity, permita o acesso e adicione a ferramenta ao agente. Passo a passo: Hubity para Copilot.

Grok

Vá para grok.com/connectors, escolha Novo conector, depois Personalizado, e cole https://hubity.io/api/mcp. O Grok faz seu login no Hubity e mostra a tela de consentimento. Em uma equipe Grok Business ou Enterprise, um administrador adiciona conectores primeiro.

Gemini

Em gemini.google.com, abra Settings → Connected Apps, escolha Adicionar um aplicativo personalizado, cole https://hubity.io/api/mcp e selecione Avançar. O Hubity registra o Gemini automaticamente, então não são necessárias credenciais de cliente; faça login e permita o acesso. O Google atualmente oferece aplicativos personalizados apenas em inglês, para pessoas com 18 anos ou mais nos EUA usando uma conta pessoal do Google.

Cursor

Adicione o Hubity em ~/.cursor/mcp.json e faça login quando o Cursor solicitar:

{
  "mcpServers": {
    "hubity": { "url": "https://hubity.io/api/mcp" }
  }
}

VS Code

Adicione o Hubity em .vscode/mcp.json e faça login quando o VS Code solicitar:

{
  "servers": {
    "hubity": { "type": "http", "url": "https://hubity.io/api/mcp" }
  }
}

Windsurf

Adicione o Hubity em ~/.codeium/windsurf/mcp_config.json e faça login quando o Windsurf solicitar:

{
  "mcpServers": {
    "hubity": { "serverUrl": "https://hubity.io/api/mcp" }
  }
}

Endpoint

POST https://hubity.io/api/mcp
Content-Type: application/json
Authorization: Bearer <access code>
MCP-Protocol-Version: 2026-07-28
Mcp-Method: tools/call
Mcp-Name: search_knowledge

Descoberta

• /.well-known/mcp/server-card.json: o cartão do servidor, com cada ferramenta e seu esquema de entrada, além dos prompts e recursos. Também disponível em /.well-known/mcp.
• /api/mcp/server.json: a entrada do Registro Oficial MCP.
• /.well-known/oauth-authorization-server: metadados do servidor de autorização OAuth 2.1 (RFC 8414).
• /.well-known/oauth-protected-resource/api/mcp: metadados de recurso protegido para o endpoint MCP (RFC 9728).

Autenticação

OAuth 2.1 (recomendado)

• Endpoint de autorização: https://hubity.io/api/mcp/oauth/authorize
• Endpoint de token: https://hubity.io/api/mcp/token
• Registro de cliente: Documentos de Metadados de ID de Cliente (um client_id HTTPS, preferido), ou registro RFC 7591 para clientes públicos em https://hubity.io/api/mcp/oauth/register
• Toda autorização mostra uma tela de consentimento; acesso de escrita (mcp:write) é concedido somente ali
• PKCE é obrigatório; code_challenge_method deve ser S256
• Tokens de atualização são rotacionados a cada uso

Códigos de acesso

Para scripts e uso em linha de comando, um administrador cria um código de acesso somente leitura, com escopo da empresa, em The Hub → Integrations → Connect an AI assistant. Um código pode ter escopo e validade definidos na criação, e ser desativado a qualquer momento. Cada requisição é registrada no log de atividades da empresa.

Escopos

• knowledge:read: pesquisar e ler documentos de conhecimento da empresa
• mcp:read: acesso de leitura em projetos, tarefas, equipe, faturamento, CRM, reuniões e folgas
• mcp:write: as três ferramentas de escrita (registros de horas, faturas de propostas aceitas, rascunhos de faturas do mês)

Ferramentas

A lista autoritativa de ferramentas, com o esquema de entrada de cada uma, é tools/list pelo protocolo MCP ao vivo ou o array tools no cartão do servidor. Categorias:

Toda ferramenta de listagem, exceto list_pto_requests, também lê um registro completo quando recebe seu id de um resultado anterior, e search_knowledge faz o mesmo para um documento.

Conhecimento

• search_knowledge

Projetos e tarefas

• list_projects, get_project_profitability
• list_tasks

Equipe e organização

• list_staff, incluindo a quem cada pessoa se reporta
• list_pto_requests

Finanças e CRM

• list_invoices
• list_proposals, create_invoice_from_proposal (escrita, precisa de mcp:write)
• list_deals
• forecast_cash_flow, get_utilization_report
• preview_month_billing, o que o faturamento do mês rascunharia; create_month_invoice_drafts (escrita, precisa de mcp:write)

Reuniões

• list_meetings

Horas

• log_time_entry (escrita, precisa de mcp:write)

Prompts e recursos

Além das ferramentas, o servidor oferece prompts prontos para as tarefas que uma empresa executa (por exemplo, faturamento do mês, trabalho em andamento no fim do mês, cobranças, quem está sobrecarregado ou um standup) e recursos que um assistente pode ler diretamente para contexto, como reuniões de hoje, um documento de conhecimento ou um único projeto. Ambos seguem as mesmas permissões das ferramentas.

As listas atuais são prompts/list, resources/list e resources/templates/list pelo protocolo MCP ao vivo, e os arrays prompts, resources e resourceTemplates no cartão do servidor.

Segurança

• Toda resposta carrega o cabeçalho MCP-Protocol-Version negociado (2026-07-28 ou 2025-11-25).
• Toda escrita é registrada no log de atividades da empresa com a pessoa que a autorizou.
• Isolamento de locatário: cada conexão é limitada a uma única empresa; leituras entre empresas são rejeitadas na camada de permissões.
• Criptografia: os dados são criptografados quando armazenados (AES-256) e em trânsito (TLS).
• Conteúdo sensível (arquivado, visibilidade pessoal, criptografado em nível de campo) nunca é retornado via MCP.
• Limites de taxa: 1.000 requisições por hora por conexão por padrão, com orçamentos maiores negociados para empresas enterprise. Descoberta anônima e endpoints OAuth têm limites menores por IP para impedir abuso.