¿Cómo crear y gestionar claves de API?

Normatia ofrece una API para que puedas integrar las funcionalidades de consulta normativa en tus propias herramientas y flujos de trabajo, y un servidor MCP para usarla desde asistentes como Claude o ChatGPT.

Quién puede crear claves

La API y el servidor MCP se activan por organización, y cada uno por su lado: una organización puede tener los dos o solo uno. En Mi cuenta > Claves API verás cuáles tiene la tuya. Si no tiene ninguno, escríbenos a hola@normatia.com y te los activamos.

Probar la API sin activarla

Cualquiera puede crear una clave de prueba en Mi cuenta > Claves API > Clave de prueba, aunque su organización no tenga la API activada. Responde con el entorno de pruebas: unas sesenta parcelas reales fijas y el catálogo de normativa, sin gastar consultas. No sirve en el servidor MCP. Lo que responde está en docs.normatia.com.

Crear una clave de API

1. Ve a Mi cuenta > Claves API.

2. Haz clic en Nueva clave.

3. Asígnale un nombre descriptivo (por ejemplo, “Plugin Revit”, “Script cálculo custom”).

4. Elige sus permisos. Vienen los tres marcados:

   • Datos: parcelas, municipios, normativa y proyectos. No gasta consultas.
   • Consultas: preguntas y comprobaciones, que gastan el cupo de tu organización.
   • MCP: conectar Claude, ChatGPT u otro asistente con esta clave.

   Quítale lo que no vaya a usar. Por ejemplo, a una aplicación que solo lee datos le basta Datos: lee todo, pero no puede gastar tus consultas.

5. Haz clic en Crear clave.

6. Copia la clave inmediatamente. Por seguridad, solo se muestra una vez.

Gestionar claves existentes

En la misma sección puedes:

• Ver todas tus claves activas (nombre, fecha de creación, últimos caracteres).
• Revocar una clave que ya no necesites o que pueda estar comprometida.
• Crear nuevas claves para distintos usos.

Seguridad

• La clave es secreta y personal. No la compartas ni la incluyas en código fuente público.
• Si otra persona necesita usar la API, aunque sea para probarla, tiene que tener su propia cuenta. Si es de tu organización, invítala a ella. Si es de otra empresa, que abra su cuenta y su organización, y escríbenos a hola@normatia.com para activarle la API.
• Si una clave se ve comprometida, revócala inmediatamente y genera una nueva.
• Cada clave es tuya y de una de tus organizaciones: la que tiene activada la API o el MCP. Si dejas esa organización, la clave deja de funcionar.
• Con la clave ves las normativas y los proyectos de la organización de la clave. Los de tus otras organizaciones no.

Límites

Las rutas de datos y el servidor MCP admiten 60 peticiones por minuto por clave y 300 por minuto en toda la organización, sumando sus claves, y los datos no gastan consultas. Las consultas y comprobaciones hechas con la clave siguen el límite por minuto del plan de su organización y cuentan en su cupo mensual igual que las de la web.