> 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

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.

<figure><img src="https://1268188283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91J5WBQDmSrL6EE6Xqez%2Fuploads%2FfHzSP3sl0Kk9wC9lxkjl%2Fmcp-api-keys.png?alt=media&amp;token=1f00b1c9-3968-4024-a52a-73708ecd30cb" alt=""><figcaption></figcaption></figure>

***

## 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 (API Tool) ou a um único projeto (Studio Tools)

## Tipos de chave

Ao criar uma chave, escolha o **Tipo**:

| Tipo             | Projetos                                                                   |
| ---------------- | -------------------------------------------------------------------------- |
| **API Tool**     | Um ou mais projetos, atribuídos pelo selo **Projetos**                     |
| **Studio Tools** | Um único projeto, escolhido na criação. A chave acessa apenas esse projeto |

A coluna **Tipo** da lista mostra o tipo de cada chave.

***

## 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).

#### Tipo

Tipo da chave: **API Tool** ou **Studio Tools**.

#### Token

Valor secreto utilizado para autenticação.

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

#### Projetos

Quantidade de projetos onde a chave está habilitada.

***

## Criando uma Nova MCP API Key

1. Clique em **Novo**.
2. Informe o **MCP API Key Name**, um nome descritivo para a chave.
3. Deixe o seletor de status ligado se quiser que a chave fique ativa imediatamente.
4. Escolha o **Tipo**: **API Tool** ou **Studio Tools**.
5. Se o tipo for **Studio Tools**, escolha o **Projeto**. A chave acessa apenas esse projeto.
6. Clique em **Adicionar**.

A chave será gerada automaticamente.

***

## Associando Projetos a uma MCP API Key

<figure><img src="https://1268188283-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91J5WBQDmSrL6EE6Xqez%2Fuploads%2FZmZkq8ZAiGdj1XzflqaQ%2Fimage.png?alt=media&amp;token=f5d510c8-d96e-4a9a-961e-c7b75e8aa50c" 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.

{% hint style="info" %}
A associação pelo selo **Projetos** vale para chaves do tipo **API Tool**. Uma chave **Studio Tools** fica presa ao projeto escolhido na criação.
{% endhint %}

***

## Renovando uma MCP API Key

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

1. Localize a chave na lista
2. Clique em **Regerar**
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 %}

***

## Conectando um agente (Studio Tools)

Nas chaves do tipo **Studio Tools**, clique no ícone de link da chave para abrir a janela **Conectar um agente**. Ela mostra a **URL do conector**, no formato `https://<seu-dominio>/api/mcp/studio`, com um botão para copiar.

{% hint style="warning" %}
O token só aparece no momento em que a chave é criada ou renovada. Para ver as instruções com o token embutido, use **Regerar**. Lembre que isso invalida o token anterior.
{% endhint %}

***

## Editando ou Excluindo uma Chave

### Editar

Permite alterar:

* Nome da chave
* Projetos associados

### Excluir

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 **Regerar**
* 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 %}
