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

# Conecte o VS Code Copilot às redes sociais via MCP

> Adicione o servidor MCP do Social media studio ao GitHub Copilot no VS Code com o .vscode/mcp.json e uma chave de API, e agende publicações pelo modo agente.

O agente GitHub Copilot do VS Code se conecta ao servidor MCP remoto **Streamable HTTP** do Social media studio
usando `type: "http"`, um `url` e um cabeçalho `X-API-Key`.

> [!NOTE]
>
> Você precisa de uma chave de API (formato `sk_live_...`) para se conectar. Gere uma em
> **Configurações > API** ou veja [Autenticação](/pt-BR/authentication.md).

## Configuração

**1. Crie o arquivo de configuração**

Crie o `.vscode/mcp.json` na raiz do projeto (ou execute **MCP: Add Server** na Command
Palette).

**2. Adicione a configuração**

```json .vscode/mcp.json theme={null}
{
  "servers": {
    "so-me-studio": {
      "type": "http",
      "url": "https://api.so-me.studio/mcp",
      "headers": {
        "X-API-Key": "sk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}
```

**3. Inicie o servidor**

Um code lens **Start** aparece acima da entrada do servidor no `.vscode/mcp.json`. Clique nele ou
deixe o VS Code perguntar se você quer iniciar o servidor quando o Copilot estiver no **Agent mode**.

**4. Verifique**

Abra o painel do Copilot Chat, mude para o modo **Agent** e clique no ícone de ferramentas. As ferramentas do
`so-me-studio` devem aparecer na lista.

## Como manter a chave fora do controle de versão

Evite fazer commit da sua chave no `.vscode/mcp.json`. Use um prompt de entrada para que o VS Code peça a chave
e a armazene com segurança:

```json .vscode/mcp.json theme={null}
{
  "inputs": [
    {
      "type": "promptString",
      "id": "so-me-api-key",
      "description": "Social media studio API key",
      "password": true
    }
  ],
  "servers": {
    "so-me-studio": {
      "type": "http",
      "url": "https://api.so-me.studio/mcp",
      "headers": {
        "X-API-Key": "${input:so-me-api-key}"
      }
    }
  }
}
```

> [!NOTE]
>
> O suporte a MCP no VS Code exige o GitHub Copilot no **Agent mode**. Confira se você tem um
> VS Code e uma extensão Copilot Chat atualizados.

## Solução de problemas

> **As ferramentas não aparecem**
>
> Confirme que `type` é `http`, que o `url` é `https://api.so-me.studio/mcp` e que o valor de `X-API-Key`
> é uma chave ativa que começa com `sk_live_`. Use o code lens **Start** ou execute
> **MCP: List Servers** para reiniciá-lo.

> **405 Method Not Allowed**
>
> O servidor do Social media studio roda em modo Streamable HTTP sem estado (somente `POST`). Mantenha
> `type: "http"` — não use um tipo de servidor SSE.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.