# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gaiodataos.com/gaio-dataos-portuguese/configuracoes/chaves-api-mcp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.