# sharely.it — guia para agentes de IA

> sharely.it hospeda **artefatos**: páginas HTML geradas por IA (relatórios, dashboards,
> propostas, landing pages) publicadas em uma URL própria, com controle de acesso,
> análise automática de segurança e de dados pessoais (LGPD) e métricas de visualização.

## O que uma IA pode fazer aqui

- Publicar um artefato HTML e devolver a URL pública para o usuário
- Atualizar um artefato existente mantendo a mesma URL (cada atualização vira uma versão)
- Listar e consultar os artefatos da conta
- Ler métricas de visualização
- Verificar se um e-mail já tem conta e criar uma conta enviando link de acesso

## Como conectar

### Claude.ai (sem instalar nada)
1. Configurações → Conectores → Adicionar conector personalizado
2. Nome: sharely.it
3. URL: https://sharelyit.com/mcp
4. Autorizar com a conta sharely.it

### Claude Desktop / GitHub Copilot / clientes MCP locais
```json
{
  "mcpServers": {
    "sharelyit": {
      "command": "npx",
      "args": ["-y", "sharelyit-mcp"],
      "env": { "SHARELYIT_TOKEN": "sat_seu_token" }
    }
  }
}
```

### ChatGPT
Adicione o conector remoto https://sharelyit.com/mcp. A descoberta OAuth 2.0 está em
https://sharelyit.com/.well-known/oauth-authorization-server (scope `offline_access` suportado).

## Ferramentas

| Ferramenta | O que faz |
| --- | --- |
| `publish_artifact` | Publica um artefato e devolve a URL pública |
| `update_artifact` | Substitui o conteúdo de um artefato existente (nova versão) |
| `publish_or_update_artifact` | Idempotente: cria se o slug estiver livre, atualiza se já for do usuário |
| `list_artifacts` | Lista os artefatos da conta |
| `get_artifact` | Detalhes de um artefato pelo slug |
| `get_stats` | Métricas de visualização |
| `get_me` | Dados da conta autenticada |
| `check_account` / `check_account_status` | Verifica existência e confirmação de uma conta |
| `create_account` | Cria conta e envia link de acesso por e-mail |
| `get_upload_url` / `upload_content` / `publish_from_upload` | Fallback avançado: envio em etapas para arquivos acima de 900 KB |

Os nomes antigos (`publish_html`, `update_html`, `list_htmls`, `get_html`,
`publish_or_update_html`) continuam funcionando como apelidos.

A publicação é direta: **não existe etapa de aprovação ou confirmação** na sharely.it.
O caminho normal é uma **única chamada** com o conteúdo inline (até 900 KB).

Toda ferramenta responde em JSON padronizado:
`{ success, action, id, slug, url, version, status }` em caso de sucesso e
`{ success: false, error_code, message }` em caso de erro.

## Exemplos em linguagem natural

- "Publica este relatório no sharely.it como vendas-q3, só para o domínio acme.com"
- "Atualiza o artefato proposta-acme com esta nova versão"
- "Cria uma conta no sharely.it para marcus@acme.com e publica este dashboard"
- "Quantas pessoas acessaram meu artefato essa semana?"
- "Lista meus artefatos publicados"

## Controle de acesso

| Tipo | Comportamento |
| --- | --- |
| `open` | Qualquer pessoa com o link acessa |
| `password` | Exige a senha definida na publicação |
| `domain` | Exige e-mail corporativo de um domínio autorizado |
| `invite` | Somente e-mails convidados, após verificação por e-mail |

## Segurança automática

- Cada artefato passa por análise de segurança e de dados pessoais antes de ficar público
- Conteúdo classificado como bloqueado não é servido
- Conteúdo com dados pessoais detectados não pode ficar com acesso aberto
- Conteúdo criptografado em repouso com AES-256-GCM
- Histórico de versões com retenção das 10 últimas

## API REST

- Base: https://sharelyit.com/api/v1/
- Recursos: `/artifacts` (alias legado: `/htmls`), `/stats`, `/me`
- Autenticação: `Authorization: Bearer sat_seu_token` (token criado em Configurações) ou OAuth 2.0
- Limite: 60 requisições por minuto por token
- Schema: https://sharelyit.com/api/v1/openapi.json

## Links

- Site: https://sharelyit.com
- Documentação: https://sharelyit.com/docs
- Como funciona: https://sharelyit.com/howitoworks
- MCP: https://sharelyit.com/mcp
- OpenAPI: https://sharelyit.com/api/v1/openapi.json
- Este arquivo: https://sharelyit.com/sharelyit.md