Statey

Guía de configuración y referencia de herramientas.

Conecta Statey a tu agente en menos de un minuto y luego pregúntale lo que quieras. Esta página te guía a través de la conexión, tu primera sesión y la superficie completa de herramientas.

En esta página

Qué es Statey

Statey es una base de datos que tu IA usa en tu nombre. Conéctala una vez (es un servidor MCP, como cualquier otro conector) y cada chat gana un lugar permanente para guardar trabajo: dile a Claude "registra este error" y se convierte en un registro en tu colección de tickets; pregúntale a Cursor la próxima semana "¿qué sigue abierto?" y consulta los mismos datos. Nunca diseñas un esquema y nunca abres una aplicación. Describe lo que quieres rastrear, y Statey construye la estructura, valida cada escritura y registra quién (tú o un agente) cambió qué. Un espacio de trabajo, cada cliente, persistente entre sesiones.

Conectar

Statey habla el protocolo MCP streamable-HTTP. Agrega el endpoint a continuación a cualquier cliente compatible con MCP y listo.

Endpoint MCP

(haz clic para copiar)

Claude (web o escritorio)

1. Abre Configuración.
2. Ve a la pestaña "Conectores".
3. Haz clic en "Agregar conector personalizado".
4. Pega la URL del endpoint y guarda.

El conector usa OAuth; se te pedirá iniciar sesión en el primer uso.

1. Ejecuta el comando a continuación en tu terminal.

claude mcp add --transport http statey https://mcp.statey.ai/mcp

Agrega Statey a tu configuración local de Claude Code. La bandera --transport http le indica a Claude Code que use el protocolo streamable-HTTP.

Cursor, Windsurf o cualquier cliente MCP

1. Abre la configuración MCP de tu cliente (generalmente un archivo de configuración JSON o un panel de "Servidores MCP").
2. Agrega una nueva entrada de servidor con el tipo de transporte configurado como streamable-HTTP (o "http") y la URL configurada con el endpoint anterior.
3. Guarda y recarga el cliente.

Si tu cliente solo admite transporte SSE, usa https://mcp.statey.ai/sse en su lugar.

Inicio rápido

Así se ve una primera sesión. No escribes nada de esto. Solo describe lo que quieres y el agente elige las herramientas adecuadas.

1Ve lo que hay en tu espacio de trabajo

¿qué hay en mi espacio de trabajo?

Herramienta get_workspace_overview llamada

Devuelve tus colecciones, conteos de registros y los permisos del agente que llama. En un espacio de trabajo nuevo, verás una lista vacía y dos plantillas iniciales disponibles.

2Crea una colección

crea un rastreador de tareas con título, estado (pendiente / en progreso / hecho), prioridad y asignado

Herramienta create_collection llamada

Statey genera un esquema a partir de tu descripción, valida los tipos de campo y devuelve un resumen. La colección está lista de inmediato.

3Agrega algunos registros

agrega tres tareas: configurar CI (prioridad alta, pendiente), escribir el readme (prioridad media, pendiente), desplegar a staging (prioridad alta, en progreso)

Herramienta create_records llamada

Los tres registros se guardan en una sola escritura de todo o nada. Cada uno recibe un id, un contador de versión y una entrada de atribución en el registro de actividad.

4Consulta tus datos

muéstrame todas las tareas de prioridad alta que aún no estén hechas

Herramienta query_records llamada

Devuelve un resultado filtrado y paginado con un conteo total. Puedes agrupar, ordenar o filtrar por cualquier campo, todo en lenguaje natural.

Referencia de herramientas

La superficie completa de herramientas para la versión actual, agrupadas por lo que hacen. No las llamas directamente; tu agente selecciona la adecuada según lo que preguntes.

Orientación

Dos herramientas proporcionan contexto: una lista lo que existe en el espacio de trabajo, la otra devuelve el esquema de una sola colección.

get_workspace_overview

Devuelve tus colecciones, conteos de registros, versiones de esquema, disparadores activos, actores y los permisos del agente que llama.

Solicitudes de ejemplo

¿qué hay en mi espacio de trabajo?

dame una visión general

describe_collection

El esquema completo de una colección: cada campo y su descripción, relaciones, registros de muestra e índices disponibles.

Solicitudes de ejemplo

¿qué campos tiene Tasks?

¿cómo están estructurados los tickets?

Dando forma a tus datos

Crea colecciones a partir de una descripción y hazlas evolucionar con el tiempo. Los cambios aditivos al esquema se aplican de inmediato; los cambios disruptivos requieren confirmación.

create_collection

Una nueva colección a partir de una descripción simple o una plantilla inicial (Tasks o Tickets). Las descripciones de campo son obligatorias; le indican al agente qué significa cada campo.

Solicitudes de ejemplo

crea un rastreador de tickets

haz una colección de clientes con nombre, plan, mrr

update_schema

Haz evolucionar una colección. Los cambios aditivos (un nuevo campo opcional, una enumeración ampliada) se aplican de inmediato; los cambios disruptivos requieren confirmación explícita. Devuelve un diff.

Solicitudes de ejemplo

agrega una fecha de renovación a clientes

agrega una opción de estado 'urgente'

Trabajando con registros

Crea, lee, consulta, actualiza y elimina registros. Las escrituras se atribuyen y están protegidas por concurrencia optimista.

create_records

Inserta de 1 a 100 registros a la vez, validados de todo o nada para que una fila incorrecta nunca quede a medias.

Solicitudes de ejemplo

nuevo ticket: el bucle de reintento del runner pierde entregas, prioridad alta

importa estas 30 tareas

get_record

Obtén un registro por id, resolviendo opcionalmente un nivel de sus relaciones (una tarea vinculada, un cliente padre).

Solicitudes de ejemplo

muestra TIC-206

muestra ese cliente y el acuerdo vinculado

query_records

Filtra, ordena y pagina (hasta 200 por página) con un conteo total. Agrupar por un campo devuelve conteos por grupo en una sola llamada.

Solicitudes de ejemplo

tickets abiertos agrupados por asignado

¿qué está en progreso ahora?

update_record

Una actualización parcial protegida por concurrencia optimista. Si el registro cambió mientras tanto, la llamada devuelve la versión actual en lugar de sobrescribirla.

Solicitudes de ejemplo

mueve TIC-206 a en progreso

sube ese ticket a prioridad alta

delete_record

Una eliminación suave. El registro desaparece de las consultas pero se conserva en el registro de actividad.

Solicitudes de ejemplo

archiva ese ticket

elimina el cliente duplicado

archive_collection

Retira una colección completa: oculta de los listados, escrituras congeladas, las lecturas siguen funcionando. Nada se elimina y se revierte limpiamente.

Solicitudes de ejemplo

archiva el tablero de sprint antiguo

congela el inventario de 2025

unarchive_collection

Devuelve una colección archivada a activa: visible de nuevo, escrituras re-habilitadas.

Solicitudes de ejemplo

restaura el tablero de sprint

desarchiva los prospectos del último trimestre

Reaccionando a cambios

Próximamente

Parte del bucle reactivo de fase 2. Cada cambio emite un evento; los disparadores coinciden con eventos y despachan agentes o webhooks.

create_trigger

Vigila una colección en busca de eventos de creación, actualización o eliminación y despacha un agente o webhook cuando coinciden con un filtro. La causalidad se rastrea a través de cascadas.

Solicitudes de ejemplo

cuando llegue un ticket, haz que triage-bot lo revise

avisa a operaciones cuando el inventario baje de 10

list_triggers · delete_trigger

Consulta qué automatizaciones están en ejecución y desactívalas.

Solicitudes de ejemplo

¿qué automatizaciones tengo?

apaga el disparador de triage

get_queue_status

Cola pendiente por agente: conteo pendiente, antigüedad del evento más antiguo y si la cola está en pausa.

Solicitudes de ejemplo

¿hay algo esperando a mis agentes?

¿está respaldada la cola?

resume_queue

Reanuda una cola en pausa: reproduce cada evento en orden o reconcilia todo el backlog contra el estado actual en una sola pasada.

Solicitudes de ejemplo

ponte al día con lo que se acumuló mientras el runner estaba caído

Auditoría y uso

El registro de actividad registra qué cambió y por qué; el uso informa el consumo contra tu límite.

query_activity

Busca en el registro inmutable por colección, registro, actor, acción o rango de tiempo, y sigue las cadenas de causalidad para ver qué desencadenó qué.

Solicitudes de ejemplo

¿quién tocó este ticket y por qué?

¿qué pasó en tickets esta semana?

get_usage

Consumo del período actual, gasto y presupuesto restante contra tu límite de gasto. Legible tanto por agentes como por personas.

Solicitudes de ejemplo

¿cuánto he usado este mes?

¿qué tan cerca estoy de mi límite?

Notas de referencia

Esta es la superficie completa de herramientas para la versión actual. Todas las escrituras se atribuyen y se registran en el registro de actividad. Las herramientas marcadas como Próximamente son parte del bucle reactivo de fase 2 y aún no están disponibles.