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

# Ferramentas do MCP · Conexão

> Ferramentas da própria conexão MCP: identidade da IA, contexto salvo (planos, documentos e memórias) e diagnóstico. Sempre liberadas.

Ferramentas da própria conexão MCP: identidade da IA, contexto salvo (planos, documentos e memórias) e diagnóstico. Sempre liberadas.

| Ferramenta | O que faz | Tipo |
| - | - | - |
| `whoami` | Nome e logo configurados nesta conexão, modo (automático/manual), se você já se apresentou, a conta (@username), os escopos e as permissões por ferramenta. | Leitura · sempre liberada |
| `connection_check` | Diagnóstico da conexão: conta, escopos, padrão de permissão, quais ferramentas rodam direto, quais estão permitidas ou bloqueadas; confirmação de ações no cliente de IA. Use logo ao conectar. | Leitura · sempre liberada |
| `set_identity` | Obrigatório no modo automático antes de qualquer outra ferramenta: grave SEU nome e SUA logo (ex.: se você é o ChatGPT, name "ChatGPT" e logo "chatgpt"). Logos: chatgpt, claude, gemini, cursor, codex, copilot, lovable, doglytdc, other. logo\_url (https) é opcional. No modo manual o dono definiu e você só lê (whoami). | Grava · sempre liberada |
| `context_list` | Planos, documentos .md e memórias salvos nesta conexão (o que você já fez e decidiu). | Leitura · sempre liberada |
| `context_read` | Conteúdo completo de um plano, documento ou memória. | Leitura · sempre liberada |
| `context_write` | Cria (sem id) ou atualiza (com id) um plano (steps: \[\{text,status}]), documento .md ou memória. Use para deixar organizado o que fez, decidiu e falta fazer. pinned=true mostra a memória ao conectar. | Grava · sempre liberada |
| `context_delete` | Apaga um item do contexto desta conexão. | Grava · sempre liberada |
| `plan_update_step` | Marca uma etapa (índice começando em 0) como todo, doing, done ou skipped. Com todas feitas, o plano fica concluído. | Grava · sempre liberada |

## whoami

**Quem sou eu nesta conexão.** Nome e logo configurados nesta conexão, modo (automático/manual), se você já se apresentou, a conta (@username), os escopos e as permissões por ferramenta.

> [!NOTE]
>
> Só leitura: não muda nada. Ferramenta da conexão: nunca pede aprovação.

### Parâmetros

Nenhum.

### Exemplo

```json Pedido theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "whoami",
    "arguments": {}
  }
}
```

```json Resposta theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...JSON da resposta... }"
      }
    ],
    "isError": false
  }
}
```

## connection\_check

**Conferir conexão.** Diagnóstico da conexão: conta, escopos, padrão de permissão, quais ferramentas rodam direto, quais estão permitidas ou bloqueadas; confirmação de ações no cliente de IA. Use logo ao conectar.

> [!NOTE]
>
> Só leitura: não muda nada. Ferramenta da conexão: nunca pede aprovação.

### Parâmetros

Nenhum.

### Exemplo

```json Pedido theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "connection_check",
    "arguments": {}
  }
}
```

```json Resposta theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...JSON da resposta... }"
      }
    ],
    "isError": false
  }
}
```

## set\_identity

**Apresentar-se.** Obrigatório no modo automático antes de qualquer outra ferramenta: grave SEU nome e SUA logo (ex.: se você é o ChatGPT, name "ChatGPT" e logo "chatgpt"). Logos: chatgpt, claude, gemini, cursor, codex, copilot, lovable, doglytdc, other. logo\_url (https) é opcional. No modo manual o dono definiu e você só lê (whoami).

> [!NOTE]
>
> Grava ou muda dados do script. Ferramenta da conexão: nunca pede aprovação.

### Parâmetros

**name** `string` *required*

Seu nome, ex.: ChatGPT

**logo** `string` *required*

Logo Valores: `chatgpt`, `claude`, `gemini`, `cursor`, `codex`, `copilot`, `lovable`, `doglytdc`, `other`.

**logo\_url** `string`

Imagem https opcional

### Exemplo

```json Pedido theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "set_identity",
    "arguments": {
      "name": "Claude",
      "logo": "claude"
    }
  }
}
```

```json Resposta theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...JSON da resposta... }"
      }
    ],
    "isError": false
  }
}
```

## context\_list

**Listar contexto salvo.** Planos, documentos .md e memórias salvos nesta conexão (o que você já fez e decidiu).

> [!NOTE]
>
> Só leitura: não muda nada. Ferramenta da conexão: nunca pede aprovação.

### Parâmetros

**kind** `string`

Filtro Valores: `plan`, `doc`, `memory`.

### Exemplo

```json Pedido theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "context_list",
    "arguments": {}
  }
}
```

```json Resposta theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...JSON da resposta... }"
      }
    ],
    "isError": false
  }
}
```

## context\_read

**Ler item do contexto.** Conteúdo completo de um plano, documento ou memória.

> [!NOTE]
>
> Só leitura: não muda nada. Ferramenta da conexão: nunca pede aprovação.

### Parâmetros

**id** `string` *required*

ID do item

### Exemplo

```json Pedido theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "context_read",
    "arguments": {
      "id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b"
    }
  }
}
```

```json Resposta theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...JSON da resposta... }"
      }
    ],
    "isError": false
  }
}
```

## context\_write

**Salvar no contexto.** Cria (sem id) ou atualiza (com id) um plano (steps: \[\{text,status}]), documento .md ou memória. Use para deixar organizado o que fez, decidiu e falta fazer. pinned=true mostra a memória ao conectar.

> [!NOTE]
>
> Grava ou muda dados do script. Ação destrutiva: confira antes de aprovar. Ferramenta da conexão: nunca pede aprovação.

### Parâmetros

**id** `string`

ID para atualizar

**kind** `string`

Tipo Valores: `plan`, `doc`, `memory`.

**title** `string`

Título

**body** `string`

Markdown

**steps** `object[]`

Lista de itens.

**campos de cada item**

**text** `string` *required*

Campo do item.

**status** `string`

Campo do item. Valores: `todo`, `doing`, `done`, `skipped`.

**note** `string`

Campo do item.

**status** `string`

Situação Valores: `active`, `done`, `archived`.

**pinned** `boolean`

—

**script\_id** `string`

Script relacionado (opcional)

### Exemplo

```json Pedido theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "context_write",
    "arguments": {
      "kind": "plan",
      "title": "Tela de configurações",
      "steps": [
        {
          "text": "Ler src/ui/theme.js",
          "status": "todo"
        },
        {
          "text": "Criar o card de configurações",
          "status": "todo"
        }
      ]
    }
  }
}
```

```json Resposta theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...JSON da resposta... }"
      }
    ],
    "isError": false
  }
}
```

## context\_delete

**Apagar item do contexto.** Apaga um item do contexto desta conexão.

> [!NOTE]
>
> Grava ou muda dados do script. Ação destrutiva: confira antes de aprovar. Ferramenta da conexão: nunca pede aprovação.

### Parâmetros

**id** `string` *required*

ID do item

### Exemplo

```json Pedido theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "context_delete",
    "arguments": {
      "id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b"
    }
  }
}
```

```json Resposta theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...JSON da resposta... }"
      }
    ],
    "isError": false
  }
}
```

## plan\_update\_step

**Atualizar etapa do plano.** Marca uma etapa (índice começando em 0) como todo, doing, done ou skipped. Com todas feitas, o plano fica concluído.

> [!NOTE]
>
> Grava ou muda dados do script. Ação destrutiva: confira antes de aprovar. Ferramenta da conexão: nunca pede aprovação.

### Parâmetros

**id** `string` *required*

ID do plano

**index** `integer` *required*

Mínimo: 0.

**status** `string` *required*

Situação Valores: `todo`, `doing`, `done`, `skipped`.

**note** `string`

Nota curta

### Exemplo

```json Pedido theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "plan_update_step",
    "arguments": {
      "id": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
      "index": 0,
      "status": "done"
    }
  }
}
```

```json Resposta theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{ ...JSON da resposta... }"
      }
    ],
    "isError": false
  }
}
```


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