---
title: "Vercel"
description: "Deploy de aplicações Next.js e serverless functions que consomem a APIBrasil via MCP ou REST na plataforma Vercel."
lang: pt-BR
canonical: https://doc.apibrasil.io/mcp/plataformas-cloud/vercel
markdown: https://doc.apibrasil.io/mcp/plataformas-cloud/vercel.md
source: apibrasil-documentation
---

# Vercel

> Deploy de aplicações Next.js e serverless functions que consomem a APIBrasil via MCP ou REST na plataforma Vercel.

- **Categoria:** Plataformas Cloud
- **Dificuldade:** Médio
- **Protocolo:** chama o gateway REST por HTTP
- **Atualizado em:** 14 de janeiro de 2026

## Pré-requisitos

- Conta na Vercel
- Projeto Next.js ou Node.js
- Vercel CLI instalado (opcional)
- Tokens da APIBrasil

## Configuração

- **Arquivo:** `api/consultar-cep.ts`

```typescript
import { NextRequest, NextResponse } from 'next/server';

export const config = {
  runtime: 'edge', // ou 'nodejs'
};

export default async function handler(req: NextRequest) {
  const { cep } = await req.json();

  const response = await fetch('https://gateway.apibrasil.io/api/v2/cep/cep', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.APIBRASIL_BEARER_TOKEN}`,
      'DeviceToken': process.env.APIBRASIL_DEVICE_TOKEN || '',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ cep }),
  });

  const data = await response.json();
  return NextResponse.json(data);
}
```

## Passo a passo

1. **Criar serverless function** — Crie um arquivo na pasta /api do seu projeto Next.js
   ```typescript
   // api/consultar-cep.ts
   import { NextRequest, NextResponse } from 'next/server';
   
   export default async function handler(req: NextRequest) {
     const { cep } = await req.json();
     
     const response = await fetch('https://gateway.apibrasil.io/api/v2/cep/cep', {
       method: 'POST',
       headers: {
         'Authorization': `Bearer ${process.env.APIBRASIL_BEARER_TOKEN}`,
         'DeviceToken': process.env.APIBRASIL_DEVICE_TOKEN || '',
         'Content-Type': 'application/json',
       },
       body: JSON.stringify({ cep }),
     });
     
     return NextResponse.json(await response.json());
   }
   ```
2. **Configurar variáveis de ambiente** — No dashboard da Vercel, vá em Settings > Environment Variables e adicione seus tokens
3. **Adicionar ao .env.local** — Para desenvolvimento local, crie um arquivo .env.local
   ```bash
   APIBRASIL_BEARER_TOKEN=seu_bearer_token
   APIBRASIL_DEVICE_TOKEN=seu_device_token
   ```
4. **Deploy para Vercel** — Faça push para o repositório ou use o Vercel CLI
   ```bash
   # Via CLI:
   vercel --prod
   
   # Via Git:
   git push origin main
   ```
5. **Testar a API** — Acesse sua função via https://seu-projeto.vercel.app/api/consultar-cep
   ```bash
   curl -X POST https://seu-projeto.vercel.app/api/consultar-cep \
     -H 'Content-Type: application/json' \
     -d '{"cep": "01001000"}'
   ```

## Solução de problemas

- **Variáveis de ambiente não carregadas** — Certifique-se de que adicionou as variáveis em TODOS os ambientes (Production, Preview, Development) no dashboard da Vercel
- **Timeout em Edge Runtime** — Edge Runtime tem limite de 30s. Para consultas mais longas, use runtime: 'nodejs' no config
- **Erro de CORS** — Adicione headers CORS na sua API route
  ```
  return NextResponse.json(data, {
    headers: {
      'Access-Control-Allow-Origin': '*',
      'Access-Control-Allow-Methods': 'POST, OPTIONS',
    },
  });
  ```
- **Build failing** — Verifique se todas as dependências necessárias estão no package.json

## Links relacionados

- [Documentação Vercel](https://vercel.com/docs)
- [Next.js API Routes](https://nextjs.org/docs/api-routes/introduction)
- [Deploy com Cloudflare](https://doc.apibrasil.io/mcp/plataformas-cloud/cloudflare.md)
- [Exemplos Next.js com APIBrasil](https://doc.apibrasil.io/mcp/exemplos/nextjs.md)

## Ver também

- Guia MCP: [Guia MCP](https://doc.apibrasil.io/mcp.md)
- Índice da documentação: https://doc.apibrasil.io/llms.txt
- Versão HTML desta página: https://doc.apibrasil.io/mcp/plataformas-cloud/vercel