Seu electrònica de les entitats falleres
Connecta Claude, ChatGPT o el teu editor a la Secretaria Virtual amb el protocol MCP. Sense autoritzar, l'assistent consulta el que és públic; amb la teua autorització, també les dades de la teua entitat. Les ferramentes d'esta pàgina ixen del catàleg del mateix servidor.
MCP (Model Context Protocol) és l'estàndard amb què un assistent d'IA crida ferramentes d'un altre servici. La Secretaria Virtual publica un servidor MCP remot en una sola adreça: l'afiges al teu assistent i ell decidix quan consultar.
Transport: HTTP «streamable», sense sessió. Autorització: OAuth 2.1 amb PKCE i registre dinàmic de clients.
https://test-jcf.alejandrofan2.dev/mcpNom suggerit: secretaria-virtual
Tria el teu assistent i seguix els passos. On es pot, hi ha un botó que l'instal·la.
Claude en la web, l'escriptori o el mòbil. El connector s'afig una vegada i apareix en tots els teus dispositius.
Pas 1: Obri Configuració › Connectors i polsa «Afegir connector personalitzat».
Pas 2: Nom: Secretaria Virtual JCF. URL del servidor:
https://test-jcf.alejandrofan2.dev/mcpPas 3: Polsa «Afegir» i després «Connectar».
Pas 4: Se obri la Secretaria: entra amb el compte de la teua entitat i polsa «Permetre».
Els connectors personalitzats depenen del teu pla de Claude; en una organització, els afig qui l'administra.
curl -X POST 'https://test-jcf.alejandrofan2.dev/mcp' \
-H "Authorization: Bearer $SV_API_KEY" \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'El catàleg del servidor, agrupat. Totes són de consulta.
saludPúblicaSols consultaComprova que la Secretaria Virtual respon i que la seua base de dades està disponible. Sense credencial.
Arguments
Cap
Prova a demanar-li: «Funciona ara mateix la Secretaria Virtual?»
buscarPública, més amb autoritzacióSols consultaEl buscador de la seu (el mateix `GET /api/v1/search`): seccions i accions («on es proposen les recompenses», «donar d'alta un faller»), tràmits amb el seu termini i si pots presentar-los, documents, pàgines d'ajuda, comunicacions i agenda; sense accents i en castellà o valencià alhora. Sense credencial, sols el que és públic. Amb la credencial d'una entitat, a més la seua Zona Privada, els seus expedients, les persones del SEU cens (mai d'una altra entitat) i els seus fils amb la Junta. El que la teua entitat no pot obrir ix amb el seu motiu i sense fragment. Cada resultat porta `path` (la ruta en la seu) i `groups` els agrupa per tipus.
Arguments
q (string, obligatori) — Texto a buscar (castellano o valenciano, sin tildes)types (array, opcional) — Solo estos tipos (por defecto, todos los que ve tu credencial)locale (es | va, opcional) — Idioma de `title` y `snippet` (por defecto, va)limit (integer, opcional) — Resultados por página (20 por defecto)cursor (string, opcional) — El nextCursor de la página anteriorProva a demanar-li: «On propose les recompenses dels meus fallers?»
impresos_buscarPública, més amb autoritzacióSols consultaEl catàleg de tràmits de la Junta per delegació: canal (`online` formulari en línia, `upload_signed` descarregar, signar i pujar per la seu, `in_person` presencial, `by_email`, `via_contact`, `external` en una altra administració, amb `channelNoteEs/Va`), termini (obert, tancat, sense termini) i per a qui és («Per a: comissions de València»…). Sense credencial veus el catàleg sencer amb la seua audiència; amb credencial, `allowed` i `reason` diuen si la TEUA entitat pot presentar-lo (`not_for_entity`, `closed`). La fitxa completa és `GET /api/v1/procedure-types/{slug}`; presentar es fa en la seu (no per MCP).
Arguments
delegation (cultura_solidaridad | deportes | festejos | infantiles_juventud | juveniles | relaciones_publicas_protocolo | incidencias | fallas | pirotecnia | censos | recompensas | medios_comunicacion | secretaria | juntas_locales, opcional) — Delegación de la Juntachannel (online | upload_signed | in_person | by_email | via_contact | external, opcional) — online · upload_signed (descargar, firmar y subir) · in_person · by_email · via_contact · externalkind (online | pdf | document, opcional) — Obsoleto (derivado del canal): online · pdf · documentq (string, opcional) — Texto a buscar en el título o la descripción (sin tildes, castellano o valenciano)Prova a demanar-li: «Quines inscripcions té obertes la delegació de Festejos?»
documentos_buscarPública, més amb autoritzacióSols consultaImpresos descarregables, documentació i normativa de la Junta, per secció, delegació o text del títol. Cadascun porta la seua audiència («Per a: …») i `allowed`/`reason`: sense credencial, el que no és públic ix «tancat» (`anonymous`); amb credencial, el que no és per a la teua entitat ix `not_for_entity`. `pendingFile` = la Junta encara no ha pujat el fitxer. La descàrrega és `GET /api/v1/documents/{id}/file`.
Arguments
category (impresos_jcf | agrupaciones | juntas_locales | ayuntamiento | jornadas | privacidad | rgcre | petardos | normativa | otros, opcional) — Sección: impresos_jcf, agrupaciones, juntas_locales, ayuntamiento, jornadas, privacidad, rgcre, petardos, normativa, otrosdelegation (cultura_solidaridad | deportes | festejos | infantiles_juventud | juveniles | relaciones_publicas_protocolo | incidencias | fallas | pirotecnia | censos | recompensas | medios_comunicacion | secretaria | juntas_locales, opcional) — Delegación de la Juntaq (string, opcional) — Texto a buscar en el título (castellano o valenciano)cursor (string, opcional) — El nextCursor de la página anteriorlimit (integer, opcional) — Filas por página (50 por defecto)Prova a demanar-li: «On està la guia del RGPD per a les falles?»
agenda_consultarPública, més amb autoritzacióSols consultaActes de la Junta i de les Falleres Majors entre dues dates (per defecte, de hui a un any). Cada acte amb la seua audiència: el que no pots vore ix sense descripció i amb el seu motiu.
Arguments
from (string, opcional) — Desde (fecha ISO, AAAA-MM-DD)to (string, opcional) — Hasta (fecha ISO)kind (junta | ffmm | otro, opcional) — junta, ffmm u otroProva a demanar-li: «Quins actes té la Junta este mes?»
comunicaciones_buscarPública, més amb autoritzacióSols consultaL'arxiu de «Correus enviats»: convocatòries, actes, avisos, instruccions… per categoria o text, el més recent primer. Cadascuna amb la seua audiència: sense credencial, el que no és públic ix «tancat»; amb credencial, el que no és per a la teua entitat, també.
Arguments
category (actas_asambleas_presidentes | actas_plenos | boletines | carteles_folletos | convocatorias_asambleas_presidentes | convocatorias_plenos | documentacion_asambleas_plenos | hojas_censos | instrucciones_bases | notas_avisos | solicitudes_inscripciones | varios | cursos_cre | otros, opcional) — Categoría de «Correos enviados»q (string, opcional) — Texto a buscar en el títulocursor (string, opcional)limit (integer, opcional)Prova a demanar-li: «Quina és l'última convocatòria de l'Assemblea de Presidents?»
entidad_consultarAmb autoritzacióSols consultaDades de l'entitat (falla, junta local…): nom, número, domicili, contacte públic. Requerix autorització (OAuth) o clau d'API; una falla sols veu la seua.
Requerix: entity:read
Arguments
entityId (string (uuid), opcional) — Id de la entidad. Sin él, la de tu credencial (una falla solo alcanza la suya).Prova a demanar-li: «Quin domicili té registrat la meua falla?»
cargos_consultarAmb autoritzacióSols consultaCàrrec → ocupant actual (presidència, secretaria, tresoreria…) en orde de rang; buit = sense cobrir. Requerix autorització amb census:read.
Requerix: census:read
Arguments
entityId (string (uuid), opcional) — Id de la entidad. Sin él, la de tu credencial (una falla solo alcanza la suya).exercise (string, opcional) — Id o etiqueta del ejercicio («2026-27»); por defecto, el en curso.Prova a demanar-li: «Qui és el secretari de la meua falla?»
censo_consultarAmb autoritzacióSols consultaCens de l'entitat en un exercici: filtres (majors, infantils, tots, baixes), cerca per nom o núm. de cens i paginació per cursor. Requerix autorització (OAuth) o clau d'API amb census:read; una falla sols veu el seu.
Requerix: census:read
Arguments
entityId (string (uuid), opcional) — Id de la entidad. Sin él, la de tu credencial (una falla solo alcanza la suya).exercise (string, opcional) — Id o etiqueta del ejercicio («2026-27»); por defecto, el en curso.filter (adults | children | all | left | everyone, opcional) — adults = mayores activos · children = infantiles activos · all = todos activos (por defecto) · left = solo bajas · everyone = todosq (string, opcional) — Nombre o apellidos, o nº de censo en fallacursor (string, opcional) — El nextCursor de la página anteriorlimit (integer, opcional) — Filas por página (50 por defecto)Prova a demanar-li: «Quants infantils hi ha en el cens de la meua falla este exercici?»
ficha_consultarAmb autoritzacióSols consultaLa fitxa d'una persona en la teua entitat (identitat tal com la té la comissió, contacte, entrada de l'exercici, recompenses, historial). L'id ix de censo_consultar. Requerix autorització amb profile:read; les fitxes d'una altra comissió no existixen per a tu.
Requerix: profile:read
Arguments
profileId (string (uuid), obligatori) — Id de la ficha (profileId de censo_consultar)exercise (string, opcional) — Id o etiqueta del ejercicio («2026-27»); por defecto, el en curso.les_meues_fallesAmb autoritzacióSols consultaPer a una junta local o una agrupació: les seues falles amb el cens actiu (majors, infantils), les baixes de l'exercici i els càrrecs clau (presidència, secretaria, tresoreria, delegació d'infantils). Només lectura. El cens d'una d'elles es consulta amb censo_consultar i el seu entityId. Amb la credencial d'una falla respon que no és una junta local ni una agrupació.
Requerix: entity:read
Arguments
entityId (string (uuid), opcional) — Id de la entidad. Sin él, la de tu credencial (una falla solo alcanza la suya).exercise (string, opcional) — Id o etiqueta del ejercicio («2026-27»); por defecto, el en curso.Prova a demanar-li: «Quants infantils té cada falla de la meua junta local?»
recompensas_propuestaAmb autoritzacióSols consultaLa proposta de recompenses de la TEUA entitat en un exercici: estat (esborrany, enviada a JCF, tornada), elaborada/actualitzada, termini, i les sol·licituds (persona, recompensa, anys de faller i de directiu, estat: pendent, acceptada, aprovada o denegada per JCF). Requerix autorització amb award:read; sols lectura (proposar i enviar es fa en la seu).
Requerix: award:read
Arguments
entityId (string (uuid), opcional) — Id de la entidad. Sin él, la de tu credencial (una falla solo alcanza la suya).exercise (string, opcional) — Id o etiqueta del ejercicio («2026-27»); por defecto, el en curso.filter (approved | denied | to_review | rejected | all, opcional) — approved = aprobadas JCF · denied = denegadas JCF · to_review = pendientes de revisar · all = todas (por defecto)Prova a demanar-li: «Quines recompenses ha aprovat ja la Junta en la nostra proposta?»
ffmm_solicitudesAmb autoritzacióSols consultaLes sol·licituds d'assistència de les Falleres Majors de la TEUA entitat (spec 18): l'acte (data, hora, lloc, comitiva demanada), l'estat de l'expedient, la decisió de Protocol (assistixen, en part o no assistixen, i qui va) i l'acte en l'agenda. Requerix autorització (OAuth) o clau d'API; una falla sols veu les seues. Presentar-les es fa en la web (Tràmits).
Requerix: procedure:read
Arguments
entityId (string (uuid), opcional) — Id de la entidad. Sin él, la de tu credencial (una falla solo alcanza la suya).Prova a demanar-li: «Vindrà la Fallera Major a la nostra presentació?»
Són les accions de l'API. L'assistent mai no té més que el teu compte, i sols sobre la teua entitat.
award:readcensus:readentity:readprocedure:readprofile:readLleva el connector en el teu assistent: deixa d'usar el seu accés, que caduca en una hora. Si cal tallar-lo ja, la Junta desactiva eixe client en Gestió JCF › Claus i assistents i es revoquen en el moment tots els seus accessos.
https://test-jcf.alejandrofan2.dev/.well-known/oauth-protected-resource/mcphttps://test-jcf.alejandrofan2.dev/.well-known/oauth-authorization-serverServidor MCP de la Secretaria Virtual de la Junta Central Fallera.
Sense credencial pots consultar l'estat del servei, el catàleg de tràmits, la biblioteca de documents, l'agenda i els correus enviats, cada cosa amb la seua audiència («Per a: …»); amb credencial, a més si la TEUA entitat pot obrir o presentar cadascuna. Amb autorització OAuth (o una clau d'API de la falla) pots consultar les dades de la TEUA entitat: fitxa, cens, fitxes dels seus membres i càrrecs.
Una credencial d'una falla sols arriba a eixa falla: si en demanes una altra, la resposta és «no trobat», no un error de permisos.
Hui totes les ferramentes són de consulta. Quan la Junta n'òbriga alguna d'escriptura, demana SEMPRE confirmació a l'usuari abans d'usar-la.
Les dades del cens són personals (inclosos menors): no les copies fora de la conversa ni les resumisques per a tercers.