Visão Geral

Conecte agentes de programação aos seus projetos Glossia através do Model Context Protocol.

Glossia expõe um Protocolo de Modelo de Contexto (MCP) servidor que permite que agentes de codificação interajam com seus projetos de localização. O servidor implementa OAuth 2.1 com PKCE e Registro Dinâmico de Clientes (RFC 7591), então, qualquer cliente compatível com o MCP pode se autenticar sem configuração manual de credenciais.

O que o servidor MCP fornece

Uma vez conectado, um agente de programação pode:

Consultar o status das traduções em todos os seus projetos
Disparar traduções e revisões
Inspeccionar configurações e entradas de conteúdo
Acessar contexto do projeto para sugestões de código mais inteligentes

URL do servidor

Ambiente	URL
Produção	`https://glossia.ai/mcp`
Desenvolvimento local	`http://localhost:4050/mcp`

Fluxo de autenticação

O servidor MCP usa o fluxo de código de autorização OAuth 2.1 padrão com PKCE. Você não precisa criar clientes OAuth manualmente. O fluxo funciona assim:

O agente descobre seu servidor através de /.well-known/oauth-authorization-server
Ele se registra como um cliente OAuth via o endpoint de registro dinâmico
Ele abre seu navegador para login e consentimento
Após você aprovar, o agente recebe um token de acesso e o anexa a todas as solicitações MCP

Adicionando o Glossia a um agente de programação

OpenAI Codex

Adicione o servidor ao arquivo de configuração do Codex em ~/.codex/config.toml:

[mcp_servers.glossia]
url = "https://glossia.ai/mcp"

Em seguida, execute o login OAuth:

codex mcp login glossia

Seu navegador abrirá para autenticação. Após a aprovação, o Codex armazena o token localmente e o usa para sessões futuras.

Para verificar a conexão:

codex mcp list

Para desenvolvimento local, substitua a URL:

[mcp_servers.glossia-local]
url = "http://localhost:4050/mcp"

Claude Code

Adicione o servidor às suas configurações do Claude Code MCP (.claude/settings.json ou ao arquivo de configuração global):

{
  "mcpServers": {
    "glossia": {
      "url": "https://glossia.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

O Claude Code gerenciará automaticamente o fluxo OAuth ao realizar a primeira conexão.

Outros clientes MCP

Qualquer cliente que suporte a especificação de autorização MCP funcionará. Os requisitos principais são:)

Transporte: HTTP Streamável
Descoberta: O cliente deve suportar Metadados de Recursos Protegidos OAuth 2.0 (RFC 9728)
Registro: Registro Dinâmico de Clientes (RFC 7591) ou Documentos de Metadados do ID do Cliente
Fluxo de autenticação: Código de autorização com PKCE (S256)

Aponte o cliente para o URL do seu servidor Glossia MCP e deixe que ele gerencie a descoberta e o registro automaticamente.

Endpoints de descoberta

O servidor publica dois documentos de metadados que clientes MCP usam para iniciar o fluxo OAuth:

Endpoint de descoberta	Descrição
`/.well-known/oauth-authorization-server`	Metadados do servidor de autorização (pontos finais, tipos de concessão suportados, métodos PKCE)
`/.well-known/oauth-protected-resource`	Metadados do recurso protegido (escopos, servidores de autorização)

Limites de taxa

Os endpoints do OAuth impõem limites de taxa para evitar abusos:

Ponto final	Limite
`POST /oauth/register`	5 solicitações por minuto
`POST /oauth/token`	30 solicitações por minuto
`POST /oauth/introspect`	30 solicitações por minuto
`POST /oauth/revoke`	30 solicitações por minuto

Quando um limite de taxa é excedido, o servidor retorna HTTP 429 com um Retry-After cabeçalho.

Solução de problemas

O registro falha com "invalid_client_metadata"

O endpoint de registro dinâmico aceita apenas valores específicos token_endpoint_auth_method valores. Clientes públicos (a maioria dos agentes de codificação) devem enviar "none", que o Glossia lida automaticamente ao recorrer aos métodos de autenticação padrão com aplicação de PKCE.