API y desarrolladores

¿Cómo conectar Normatia con herramientas externas mediante MCP?

Cómo usar el servidor MCP de Normatia para integrar el asistente IA en herramientas como Cursor, Claude Desktop o copilotos personalizados.

Normatia ofrece un servidor MCP (Model Context Protocol) que permite a asistentes de IA externos consultar la normativa, los datos de parcelas y municipios y tus proyectos.

¿Qué es MCP?

MCP es un protocolo abierto que permite a modelos de IA conectarse a fuentes de datos externas de forma estandarizada. Con el servidor MCP de Normatia, puedes dar a Claude, Cursor u otros asistentes la capacidad de consultar normativa técnica española.

Cómo conectar

La configuración y los detalles de conexión están en normatia.com/es/mcp y, cliente por cliente, en docs.normatia.com/mcp.

El servidor MCP se activa por organización. En Mi cuenta > Claves API verás si la tuya lo tiene; si no, escríbenos a hola@normatia.com y te lo activamos.

La dirección del servidor es https://mcp.normatia.com/mcp/. Hay dos formas de conectarlo:

  1. Con tu cuenta (OAuth): añade la dirección en tu cliente. En Claude, ve a Customize > Connectors, pulsa + Add y luego Add custom connector, y escribe un nombre y la dirección. El cliente abrirá Normatia para que inicies sesión y te enseñará qué asistente pide acceso antes de que pulses Permitir.
  2. Con una clave de API: para clientes que no hacen OAuth, como Cursor, envía la cabecera Authorization: Bearer sk-normatia-.... Las claves de prueba no sirven en el servidor MCP.

¿Qué permite hacer?

Una vez conectado, el asistente tiene once herramientas. Nueve son de datos: solo leen y no gastan consultas.

  • get_parcel y find_parcel: una parcela por su referencia catastral, por un punto o por su dirección, con sus afecciones y su planeamiento.
  • get_place: un municipio y sus datos técnicos (zona climática, sismicidad, nieve, viento…), cada uno con la norma de la que sale.
  • search_regulations, get_regulation_contents y read_regulation_section: el catálogo de normativa, el índice de cada norma y el texto de cada sección.
  • list_projects y get_project_info: tus proyectos y el contexto de cada uno (ubicación, normativa aplicable y documentos).
  • get_usage: el consumo de tu organización y las consultas que quedan este mes.

Y dos para preguntar:

  • ask: responde preguntas técnicas sobre un proyecto, un municipio o una parcela, con citas a la normativa. Tarda de 10 a 60 segundos, cada pregunta gasta una consulta del mes de tu organización y su conversación queda guardada.
  • get_answer: recoge una pregunta de ask que seguía en marcha, sin gastar otra.

Con OAuth, el asistente solo ve ask y get_answer si al conectar dejas marcada la casilla Hacer consultas en tu nombre. Con una clave, si la clave tiene el permiso de consultas.

Casos de uso

  • Cursor / Windsurf / Copilot: el IDE puede consultar la normativa mientras escribes código relacionado con building information modeling.
  • Claude Desktop: el asistente de escritorio accede a la normativa actualizada sin necesidad de copiar y pegar artículos.
  • Automatizaciones personalizadas: integración con scripts, herramientas internas del estudio o plugins de software BIM.

¿No encuentras lo que buscas?

Contactar con soporte