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

# Servidor MCP

> Aprenda a integrar o servidor MCP da SUNRA com Cursor, VS Code, Cline, Windsurf e outros ambientes de desenvolvimento para acesso contínuo a modelos de IA.

# Configurando o Servidor MCP da SUNRA

O servidor do Protocolo de Contexto de Modelo (MCP) da SUNRA oferece integração perfeita com ambientes de desenvolvimento populares, permitindo que você acesse os modelos de IA da SUNRA diretamente do seu editor ou IDE. Este guia o guiará pela configuração do servidor MCP com várias ferramentas.

## O que é MCP?

O Protocolo de Contexto de Modelo (MCP) é uma forma padronizada para assistentes de IA acessarem com segurança recursos e ferramentas externas. O servidor MCP da SUNRA permite que você:

* **Liste e pesquise modelos de IA** disponíveis na SUNRA
* **Envie solicitações** para qualquer endpoint de modelo
* **Verifique o status** e recupere resultados do sistema de filas
* **Faça upload de arquivos** e gerencie esquemas de modelos
* **Gerencie a autenticação da API** de forma transparente

## Pré-requisitos

Antes de configurar o servidor MCP, certifique-se de ter:

1. **Node.js** instalado (versão 18 ou superior)
2. **Chave de API da SUNRA** do [seu painel](https://sunra.ai/dashboard/api-tokens)
3. Seu editor/IDE preferido instalado

## Instalação

O servidor MCP da SUNRA está disponível como um pacote npm:

```bash theme={null}
npm install -g @sunra/mcp-server
```

Ou use-o diretamente com npx (recomendado):

```bash theme={null}
npx @sunra/mcp-server
```

## Configuração por Editor

### Cursor

O Cursor suporta MCP por meio de seu arquivo de configuração. Crie ou atualize `.cursor/mcp.json` na raiz do seu projeto:

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"]
    }
  }
}
```

**Configuração global alternativa** em suas configurações de usuário:

1. Abra as Configurações do Cursor
2. Navegue até "Servidores MCP"
3. Adicione um novo servidor com:
   * **Nome**: `sunra-mcp-server`
   * **Comando**: `npx`
   * **Argumentos**: `@sunra/mcp-server`

### VS Code

Para VS Code com suporte a MCP (requer extensão compatível):

Crie `.vscode/mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "env": {
        "SUNRA_KEY": "your-api-key-here"
      }
    }
  }
}
```

### Cline

O Cline suporta servidores MCP por meio de suas configurações. Adicione à sua configuração do Cline:

```json theme={null}
{
  "mcpServers": {
    "sunra": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "description": "Acesso a modelos de IA da SUNRA"
    }
  }
}
```

### Windsurf

Para o Windsurf IDE, configure o MCP nas configurações do espaço de trabalho:

```json theme={null}
{
  "mcp": {
    "servers": {
      "sunra-mcp-server": {
        "command": "npx",
        "args": ["@sunra/mcp-server"],
        "timeout": 30000
      }
    }
  }
}
```

### Claude Desktop

Adicione ao seu arquivo de configuração do Claude Desktop:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"]
    }
  }
}
```

### Outras Ferramentas Compatíveis com MCP

Para qualquer outra ferramenta que suporte MCP, use este padrão de configuração geral:

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "env": {
        "SUNRA_KEY": "${SUNRA_KEY}"
      }
    }
  }
}
```

## Configuração do Ambiente

### Configurando sua Chave de API

Você pode configurar sua chave de API da SUNRA de várias maneiras:

#### Opção 1: Variável de Ambiente (Recomendado)

```bash theme={null}
export SUNRA_KEY="your-api-key-here"
```

Para Windows:

```cmd theme={null}
set SUNRA_KEY=your-api-key-here
```

#### Opção 2: Arquivo de Configuração

Alguns editores permitem que você defina variáveis de ambiente diretamente na configuração do MCP:

```json theme={null}
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "env": {
        "SUNRA_KEY": "your-api-key-here"
      }
    }
  }
}
```

#### Opção 3: Configuração em Tempo de Execução

O servidor MCP também suporta a configuração da chave de API em tempo de execução usando a ferramenta `set-sunra-key`.

## Ferramentas MCP Disponíveis

Uma vez configurado, você terá acesso a estas ferramentas por meio do seu assistente de IA:

### Gerenciamento de Modelos

* `list-models` - Navegue por todos os modelos de IA disponíveis
* `search-models` - Encontre modelos por palavras-chave
* `model-schema` - Obtenha esquemas de entrada/saída para modelos específicos

### Gerenciamento de Solicitações

* `submit` - Envie solicitações para endpoints de modelo
* `status` - Verifique o status da solicitação e os logs
* `result` - Recupere resultados concluídos
* `cancel` - Cancele solicitações em execução
* `subscribe` - Envie e aguarde a conclusão

### Gerenciamento de Arquivos

* `upload` - Faça upload de arquivos para o armazenamento da SUNRA

## Exemplos de Uso

### Listando Modelos Disponíveis

```
Use a ferramenta list-models para me mostrar quais modelos de IA estão disponíveis.
```

### Gerando uma Imagem

```
Use a ferramenta submit para gerar uma imagem com o endpoint black-forest-labs/flux-1.1-pro/text-to-image.
Use o prompt: "Uma paisagem de montanha serena ao pôr do sol"
```

### Verificando o Status da Solicitação

```
Verifique o status do ID da solicitação: pd_xxxxxx
```

## Solução de Problemas

### Problemas Comuns

**Servidor MCP não encontrado**

* Certifique-se de que o Node.js está instalado e acessível
* Tente instalar globalmente: `npm install -g @sunra/mcp-server`
* Verifique se o caminho do comando está correto

**Erros de Autenticação**

* Verifique se a sua variável de ambiente SUNRA\_KEY está definida
* Verifique se a sua chave de API é válida no [Painel da SUNRA](https://sunra.ai/dashboard/api-tokens)
* Tente definir a chave usando a ferramenta `set-sunra-key`

**Tempos Limite de Conexão**

* Aumente os valores de tempo limite em sua configuração
* Verifique sua conexão com a internet
* Verifique o status da API da SUNRA

**Erros de Permissão**

* Garanta as permissões de arquivo adequadas para os arquivos de configuração
* Tente executar com as permissões de usuário apropriadas

### Obtendo Ajuda

Se você encontrar problemas:

1. Verifique a [Documentação da SUNRA](https://docs.sunra.ai)
2. Revise a documentação do MCP do seu editor
3. Abra um problema no [GitHub](https://github.com/sunra-ai/sunra-clients/issues)

## Próximos Passos

Depois que seu servidor MCP estiver configurado:

1. **Explore Modelos**: Use `list-models` para ver todas as capacidades de IA disponíveis
2. **Tente Exemplos**: Comece com gerações simples de texto para imagem ou texto para vídeo
3. **Crie Fluxos de Trabalho**: Combine vários modelos para pipelines de IA complexos
4. **Monitore o Uso**: Acompanhe o uso da sua API no [Painel da SUNRA](https://sunra.ai/dashboard/)

A integração do MCP facilita a incorporação de modelos de IA poderosos diretamente em seu fluxo de trabalho de desenvolvimento, permitindo a prototipagem rápida e recursos perfeitos alimentados por IA em seus aplicativos.