Integração do Protocolo de Contexto de Modelo (MCP)

A API Travel Impact Model (TIM) oferece suporte ao Protocolo de Contexto de Modelo (MCP, na sigla em inglês), um padrão aberto criado para que agentes de IA e modelos de linguagem grandes (LLMs, na sigla em inglês) interajam com APIs e ferramentas. Ao usar o endpoint do MCP, os agentes de IA podem descobrir e usar dinamicamente os recursos da API TIM para calcular as emissões de voos.

Para mais informações sobre o protocolo, consulte a Especificação do Protocolo de Contexto de Modelo.

Endpoint

O endpoint do MCP para a API Travel Impact Model é:

https://travelimpactmodel.googleapis.com/mcp

Todas as interações do MCP são realizadas enviando solicitações POST JSON-RPC 2.0 para esse endpoint.

Autenticação

O endpoint do MCP usa os mesmos métodos de autenticação da API Travel Impact Model padrão. É necessário fornecer uma chave de API válida do seu projeto na nuvem do Google Cloud, garantindo que a "API Travel Impact Model" esteja ativada.

Métodos principais do MCP

As interações com o endpoint do MCP usam principalmente dois métodos:

  • tools/list: descobre as ferramentas disponíveis, as descrições delas e os esquemas JSON de entrada/saída.
  • tools/call: executa uma ferramenta específica com os argumentos fornecidos.

Ferramentas disponíveis

As seguintes funcionalidades são expostas como ferramentas:

  • compute_flight_emissions: recupera emissões detalhadas de voos específicos.
  • compute_typical_flight_emissions: recupera emissões típicas entre pares de aeroportos, sem exigir detalhes específicos do voo.
  • compute_scope3_flight_emissions: recupera emissões de voos históricos, adequadas para relatórios de escopo 3.

Os esquemas exatos de entradas e saídas são fornecidos na resposta tools/list.

Integrar com agentes de IA

Configure aplicativos de IA populares usando estas instruções. Substitua YOUR_API_KEY pela chave da API Travel Impact Model.

CLI do Gemini

Para configurar a CLI do Gemini, siga estas etapas:

  1. Crie um arquivo de extensão em ~/.gemini/extensions/travel-impact-model/gemini-extension.json.

  2. Salve o conteúdo a seguir no arquivo:

    {
  "name": "travel-impact-model",
  "version": "3.0.0",
  "mcpServers": {
    "travel-impact-model": {
      "httpUrl": "https://travelimpactmodel.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

  3. Inicie a CLI do Gemini executando gemini no terminal.

  4. Execute /mcp list para verificar se o servidor travel-impact-model está configurado e se as ferramentas dele estão disponíveis.

Antigravity

Para configurar Antigravity para usar o servidor MCP:

  1. No Antigravity, clique no menu Opções adicionais no painel do agente > Servidores MCP > Gerenciar servidores MCP.

  2. Na parte de cima do painel "Gerenciar servidores MCP" que é aberto, clique em Ver configuração bruta para editar o arquivo mcp_config.json:

    {
  "mcpServers": {
    "TravelImpactModel": {
      "serverUrl": "https://travelimpactmodel.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

  3. Volte para Gerenciar servidores MCP e clique em Atualizar.

Exemplos de interações

Depois de configurado, você pode interagir com a API TIM pelo agente de IA usando linguagem natural.

Usuário:quais são as emissões do voo LX 52 de Zurique para Boston?

Agente:as emissões de carbono projetadas por passageiro do voo LX 52 da Swiss International Air Lines de Zurique (ZRH) para Boston (BOS) para hoje, 25 de março de 2026, são as seguintes:

  • Econômica:354,10 kg de CO2e
  • Econômica premium:531,14 kg de CO2e
  • Executiva:1.416,38 kg de CO2e
  • Primeira classe:1.770,48 kg de CO2e

Esse voo tem um impacto moderado de rastros de condensação.

Usuário:quais são as emissões típicas de Zurique para Boston?

Agente:as emissões de carbono típicas por passageiro de um voo de Zurique (ZRH) para Boston (BOS) são as seguintes:

  • Economia:415,41 kg de CO2e
  • Econômica premium:582,00 kg de CO2e
  • Executiva:1.473,95 kg de CO2e
  • Primeira classe:1.817,35 kg de CO2e