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

# Herramientas del Estudio

> Stack tecnológico de NSS Abogados

## Herramientas principales

* **Slack** — Comunicación interna, interacción con Ark (nssabogados.slack.com)
* **Google Workspace** — Email, Calendar, Drive, Docs (Gmail corporativo)
* **Google Workspace CLI (`gws`)** — Operaciones avanzadas: crear carpetas, descargar adjuntos, labels, filtros
* **Notion** — Wiki interna, bases de datos, documentación (notion.so)
* **Asana** — Gestión de proyectos y tareas (asana.com)
* **Piriod** — Facturación y suscripciones (piriod.com)
* **NSS App** — Aplicación interna del estudio
* **SII** — Trámites tributarios (sii.cl)
* **Mintlify** — Documentación interna en team.nss.cl

## Slack — Canal principal

Slack es la herramienta central de comunicación. Ark opera desde Slack y responde a solicitudes del equipo.

**Regla clave**: Todas las conversaciones van en **hilos** (threads), nunca mensajes sueltos al canal.

## Gmail — Acceso Multi-Bandeja

Ark tiene acceso a las bandejas de correo de todo el equipo via delegación de dominio de Google Workspace.

**Reglas de acceso:**

* Cada persona solo puede usar a Ark para leer **su propia bandeja**. Ark identifica al usuario por su perfil de Slack.
* Ark puede **leer correos** y **crear borradores** en la bandeja del usuario que lo invoca.
* Ark **nunca envía** correos desde la bandeja de otra persona.
* **Clemente** puede pedir acceso a cualquier bandeja (excepción de Managing Partner).
* Ark siempre informa en el hilo de Slack qué bandeja consultó.

**Ejemplos:**

```
@Ark busca el correo de Kellu en mi bandeja
→ Ark lee la bandeja del usuario que escribió el mensaje

@Ark crea un draft de respuesta para el correo de X
→ Ark crea borrador en la bandeja del usuario, nunca envía
```

## Google Drive — Estructura

Los documentos de clientes se organizan por portafolio:

```
📁 NSS Drive
  📁 Internacionales
    📁 [Cliente A]
    📁 [Cliente B]
  📁 Crypto
  📁 27 Bis
  📁 RRHH
  📁 Contabilidad
  📁 Financiero
  📁 Outsourcing Laboral
```

## Google Workspace CLI (`gws`)

Además del MCP de Google Workspace, Ark usa la herramienta `gws` para operaciones avanzadas:

* **Crear carpetas** en Drive
* **Subir archivos** a Drive
* **Descargar adjuntos** de Gmail
* **Crear labels y filtros** en Gmail
* **Mover archivos** entre carpetas

## Piriod — Facturación (25 herramientas)

Dos entidades configuradas:

* **NSS Limitada** — Entidad principal
* **NSS SpA** — Entidad secundaria

Ark tiene acceso completo a Piriod via API:

* **Clientes**: listar, buscar, crear, editar, eliminar
* **Facturas**: crear (one-time), finalizar, anular, descargar PDF
* **Suscripciones**: crear, listar, consultar
* **Notas de Crédito**: crear, finalizar, descargar PDF
* **Uso**: registrar consumo en suscripciones medidas
* **Catálogo**: planes, productos, documentos tributarios

> ⚠️ Solo se emiten documentos tributarios **exentos**. Facturas afectas (CL33) y boletas afectas (CL39) están bloqueadas a nivel de código.

## Integraciones MCP de Ark

Ark se conecta a estos servicios via MCP (Model Context Protocol):

* **slack** — Lectura y respuesta en canales
* **google-workspace** — Gmail, Calendar, Drive
* **notion** — Wiki y bases de datos
* **asana** — Proyectos y tareas
* **puppeteer** — Automatización web (SII)
* **pinecone** — Base de conocimiento (RAG)
* **brave-search** — Búsqueda web
* **filesystem** — Archivos locales
* **piriod** — Facturación (MCP custom, 25 tools)


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