> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/gaio-dataos-portuguese/configuracoes/chaves-api-mcp.md).

# Chaves API MCP

<figure><img src="/files/P8BbBcnkXx38FMX0QQSi" alt=""><figcaption></figcaption></figure>

A seção **MCP API Keys** permite criar e gerenciar chaves de acesso seguras utilizadas por ferramentas MCP e integrações dentro do Gaio DataOS. Essas chaves controlam quais projetos podem acessar recursos habilitados via MCP e integrações externas.

***

## O que é uma MCP API Key?

Uma **MCP API Key** é um token de autenticação vinculado a um projeto, utilizado para:

* Autorizar ferramentas MCP
* Permitir comunicação segura entre o Gaio e serviços externos compatíveis com MCP
* Controlar acesso no nível de projeto

Cada chave pode ser:

* Ativada ou desativada individualmente
* Renovada (rotacionada)
* Associada a um ou mais projetos

***

## Visualizando MCP API Keys Existentes

Acesse:

**Settings → MCP API Keys**

Nesta tela, você verá as seguintes colunas:

#### ID

Identificador interno da chave.

#### Status

Indica se a chave está:

* **Active** – Pode ser utilizada normalmente
* **Inactive** – Está desabilitada

#### Nome

Nome descritivo da chave (ex: OpenAI, Internal MCP, Automation Key).

#### Token

Valor secreto utilizado para autenticação.

* Os tokens ficam ocultos por padrão
* É possível clicar em **Renew** para gerar um novo token

#### Projetos

Quantidade de projetos onde a chave está habilitada.

***

## Criando uma Nova MCP API Key

1. Clique em **New**
2. Preencha o campo:

* **MCP API Key Name**\
  Nome descritivo da chave

3. Ative o **Status** caso deseje que a chave esteja ativa imediatamente
4. Clique em **Add**

A chave será gerada automaticamente.

***

## Associando Projetos a uma MCP API Key

<figure><img src="/files/D3xiQavki5O1mrl4KaRO" alt=""><figcaption></figcaption></figure>

Após criar a chave:

1. Clique no badge **Projetos**
2. Selecione um ou mais projetos
3. Confirme a associação

Apenas os projetos selecionados poderão utilizar essa MCP API Key.

***

## Renovando uma MCP API Key

Se o token for comprometido ou precisar de rotação:

1. Localize a chave na lista
2. Clique em **Renew**
3. Um novo token será gerado
4. Atualize os sistemas externos que utilizam essa chave

{% hint style="danger" %}
Ao renovar, o token anterior é invalidado imediatamente.
{% endhint %}

***

## Editando ou Excluindo uma Chave

### Edit

Permite alterar:

* Nome da chave
* Projetos associados

### Delete

Remove permanentemente a chave.

Qualquer integração que utilize essa chave deixará de funcionar imediatamente.

***

## Boas Práticas

* Utilize uma MCP API Key por integração ou finalidade
* Associe a chave apenas aos projetos que realmente precisam de acesso
* Realize rotação periódica utilizando **Renew**
* Desabilite ou exclua chaves que não estejam em uso
* Nunca compartilhe tokens em repositórios públicos ou código client-side

***

## Segurança

* MCP API Keys são armazenadas com segurança e mascaradas na interface
* Tokens são exibidos apenas no momento da criação ou renovação
* O controle de acesso é aplicado no nível de projeto
* Chaves podem ser revogadas instantaneamente ao serem desativadas ou excluídas

{% hint style="info" %}
As **MCP API Keys** fornecem uma forma controlada, auditável e segura de conectar o Gaio DataOS a ferramentas MCP e sistemas externos.
{% endhint %}