> ## Documentation Index
> Fetch the complete documentation index at: https://freshbase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Como configurar integrações

> Como conectar serviços externos ao Freshbase para potencializar seu workflow.

Ao final deste guia, você saberá como conectar serviços externos ao Freshbase para potencializar seu workflow.

## Acessando as integrações

1. Clique em **Configurações** no menu lateral
2. Clique em **Integrações** na barra lateral

## Integrações disponíveis

### Google Calendar

Sincroniza suas reuniões para facilitar convites e transcrições.

**Como conectar:**

1. Em **Integrações**, encontre **Google Calendar**
2. Clique em **Conectar Google Calendar**
3. Uma janela do Google vai abrir — autorize o acesso
4. Após autorizar, o status muda para **Conectado**

**O que acontece depois:**

* O Freshbase pode sugerir contatos do calendário ao convidar membros
* Reuniões do calendário podem aparecer na seção **Reuniões > Próximas**
* Facilita a criação automática de transcrições

**Para desconectar:** Clique em **Desconectar** na seção do Google Calendar.

**Para reconectar:** Se a conexão expirar, clique em **Reconectar Google Calendar**.

### Linear

Integra com o Linear para criar e sincronizar tarefas de desenvolvimento.

**Como conectar:**

<Steps>
  <Step title="Encontrar">Em **Integrações**, encontre **Linear**</Step>
  <Step title="Conectar">Clique em **Conectar Linear**</Step>
  <Step title="API Key">Gere uma API Key pessoal nas configurações do Linear e copie</Step>
  <Step title="Colar">Cole a API Key no campo correspondente</Step>
  <Step title="Testar">Clique em **Testar** para verificar a conexão</Step>
  <Step title="Salvar">Clique em **Salvar**</Step>
</Steps>

**O que acontece depois:**

* Você pode criar issues no Linear diretamente do Chat
* Tarefas extraídas de reuniões podem ser enviadas para o Linear
* O assistente pode buscar e referenciar issues existentes

### Upload de transcrição

Permite importar transcrições de ferramentas externas.

**Formatos aceitos:**

* Granola
* Fireflies
* Tactiq
* Notes (formato genérico)

Não requer configuração especial — basta fazer upload na seção **Reuniões**.

## Integrações avançadas

### Chaves MCP (Claude Code)

Se você usa o Claude Code e quer conectá-lo à sua Base:

1. Vá em **Configurações > Segurança > Chave MCP**
2. Clique em **Nova chave MCP**
3. Selecione a **Base vinculada**
4. Dê um **nome** para a chave (opcional)
5. Clique em **Gerar chave**
6. **Copie a chave imediatamente** — ela só aparece uma vez

Cada chave MCP:

* É vinculada a uma Base específica
* Pode ser revogada individualmente em **Configurações > Segurança**
* Mostra quando foi criada e o último uso

### Fireflies.ai (webhook)

Para receber transcrições automaticamente do Fireflies:

1. No Fireflies, configure um webhook apontando para seu Freshbase
2. Quando uma reunião for processada no Fireflies, a transcrição chega automaticamente
3. O Freshbase processa e gera itens no Inbox

## Todas as integrações são opcionais

Nenhuma integração é obrigatória para usar o Freshbase. Você pode configurá-las a qualquer momento em **Configurações > Integrações**. O onboarding também lembra das integrações disponíveis no último passo.

## Problemas comuns

<AccordionGroup>
  <Accordion title="Google Calendar não está configurado no ambiente do servidor">
    Esta mensagem aparece quando o ambiente do servidor não tem as credenciais do Google Calendar configuradas. Entre em contato com o administrador da sua instância.
  </Accordion>

  <Accordion title="Não consigo testar a conexão com o Linear">
    Verifique se a API Key está correta e se ela tem permissões suficientes. Gere uma nova chave no Linear se necessário.
  </Accordion>

  <Accordion title="Perdi minha chave MCP">
    Chaves MCP só são exibidas uma vez. Se perdeu, revogue a chave antiga e gere uma nova.
  </Accordion>
</AccordionGroup>

<Card title="Próximo passo" icon="arrow-right" href="/personas/product-owner">
  Explore os guias por persona
</Card>