MCP konektory: nacte nastroje ze serveru a udela z nich kroky

Firma si zalozi napojeni na svuj MCP server, stiskne Nacist nastroje a jeho
nastroje se objevi v builderu jako kroky automatizace vcetne toho, jake
promenne prijimaji a jake vraceji.

Pribylo:
- sluzba `mcp` - jedina v katalogu bez pevnych operaci, rekne je az server.
  Udaje: adresa serveru, token nebo klic v X-API-Key
- POST /connectors/:id/mcp/tools - zepta se serveru na tools/list a ulozi
  vysledek. Je to zaroven overeni konektoru, proto u MCP neni tlacitko Overit
- src/mcp/client.ts - handshake, sezeni z hlavicky odpovedi, odpoved jako JSON
  i jako SSE stream, strankovani nastroju, nic z toho nevyhazuje vyjimku
- src/mcp/schema.ts - ze schematu vzniknou pole kroku a zpatky se z vyplnenych
  retezcu udelaji argumenty ve spravnych typech. Ten druhy smer je ten
  podstatny: server ceka {"limit": 10}, ne {"limit": "10"}
- src/data/mcpTools.ts - nastroje v katalogu, kes nad tim, co je u konektoru
- sloupec `mcp` u konektoru (migrace 004). Bez ulozeni by po restartu zmizely
  z katalogu kroky, ktere uzivatel uz ma ve stromech
- vnitrni krok runMcpTool - jedna obsluha pro vsechny nastroje vsech serveru

Rozhodnuti:
- nastroj patri firme, ne katalogu. serviceCatalog(tenantId) bez firmy nevrati
  zadny, takze zapomenuty argument znamena "nic", ne "vsechno"
- ID operace nese ID konektoru (tool:<konektor>:<nastroj>), protoze firma muze
  mit dva servery a na obou nastroj `search`
- krok se neopakuje, MCP nema idempotencni klic
- chyba nemaze nastroje, vypadek serveru nesmi vymazat kroky z automatizaci
- servery se pri startu neobvolavaji, jeden nedostupny by shodil katalog vsem

Dokumentace: prepsany 24-mcp-konektory.md na skutecny stav, novy
00-pro-programatory.md (rozcestnik, model ctyr pojmu, pravidla, ktera plati
vsude, co je krehke), doplnene 01, 12 a 99.

Mimochodem opraveno: setStatus v connectors/postgres.ts melo v RETURNING
doslovny retezec ${COLUMNS} misto dosazeni, a dva odstavce v dokumentu 12 byly
dvakrat.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

src/openapi.ts

@@ -1785,6 +1785,63 @@ export function buildOpenApiDocument() {
           },
         },
       },
+      '/api/dashboard/connectors/{id}/mcp/tools': {
+        post: {
+          tags: ['Konektory'],
+          summary: 'Nacist nastroje MCP serveru',
+          description:
+            'Zepta se MCP serveru na tools/list a ulozi vysledek ke konektoru. Je to jedina ' +
+            'sluzba, u ktere seznam operaci neurcuje katalog, ale az sam server - teprve tim ' +
+            'vzniknou kroky, ktere jde davat do automatizaci, vcetne toho, jake promenne ' +
+            'prijimaji a jake vraceji. Zaroven to je overeni konektoru, proto se zapisuje do ' +
+            'historie: kdyz server odpovi seznamem, adresa i token sedi. Cteci volani, nic ' +
+            'nemeni. Prazdny vysledek se ulozi (server uz nastroje nenabizi), chyba nemeni nic ' +
+            '- vypadek serveru nesmi vymazat kroky z hotovych automatizaci. Neuspech neni ' +
+            'chyba API, vraci se 200 s ok: false.',
+          security: [{ bearerAuth: [] }],
+          parameters: [{ name: 'id', in: 'path', required: true, schema: { type: 'string' } }],
+          responses: {
+            '200': {
+              description: 'Vysledek nacteni',
+              content: {
+                'application/json': {
+                  schema: {
+                    type: 'object',
+                    properties: {
+                      ok: { type: 'boolean' },
+                      checked: { type: 'string' },
+                      message: { type: 'string' },
+                      status: { type: 'integer' },
+                      detail: { type: 'string' },
+                      server: { type: 'string', description: 'Jak se server predstavil.' },
+                      protocolVersion: { type: 'string' },
+                      tools: {
+                        type: 'array',
+                        items: {
+                          type: 'object',
+                          properties: {
+                            name: { type: 'string' },
+                            label: { type: 'string' },
+                            description: { type: 'string' },
+                            inputs: {
+                              type: 'array',
+                              items: { type: 'string' },
+                              description: 'Nazvy parametru, povinne s hvezdickou na konci.',
+                            },
+                            outputs: { type: 'array', items: { type: 'string' } },
+                          },
+                        },
+                      },
+                    },
+                  },
+                },
+              },
+            },
+            '400': { description: 'Sluzba neni MCP server' },
+            '404': { description: 'Konektor neexistuje' },
+          },
+        },
+      },
       '/api/dashboard/connectors/{id}/checks': {
         get: {
           tags: ['Konektory'],