MCP Fusion/Get started/Schnellstart

Schnellstart

Frag die KI über Vinkius

Bauen Sie einen ersten Connector mit MCP Fusion: ein Query-Tool, ein Presenter mit PII-Schwärzung, eine Verbindung von Claude Desktop und ein kostenloses Deployment auf Vinkius Cloud.

Dieser Quickstart baut einen kleinen Billing-Connector: ein Tool, das eine Rechnung zurückgibt, ein Presenter, der Kunden-PII aus dem Modellkontext fernhält, eine Live-Verbindung von einem MCP-Client und ein kostenloses Deployment auf Vinkius Cloud. Er setzt voraus, dass Sie @mcpfusion/core installiert und wie in Installation gezeigt ein Projekt erzeugt haben.

1. Server erstellen

typescript

import { initMCPFusion } from '@mcpfusion/core';

const f = initMCPFusion();

export default f;

initMCPFusion() gibt eine Registry mit den fluenten Tool-Buildern zurück. Der generische Parameter AppContext ist optional: Wenn Sie einen Typ angeben, erhält jeder Handler und jede Middleware ein typisiertes ctx.

2. Einen Presenter definieren

typescript

import { createPresenter, t } from '@mcpfusion/core';

const InvoicePresenter = createPresenter('Invoice')
  .schema({
    id: t.string,
    customer: t.string,
    amount_cents: t.number.describe('CENTS, divide by 100'),
    status: t.enum('draft', 'paid', 'overdue'),
  })
  .redactPII(['customer.email', 'customer.ssn'])
  .rules([
    'amount_cents is in CENTS. Divide by 100 before showing money.',
  ])
  .limit(50);

Hier passieren drei Dinge. Das Schema sagt exakt, welche Felder existieren, sodass nicht deklarierte Spalten den Agenten nie erreichen. .redactPII() entfernt die gelisteten Pfade bei jeder Antwort. .rules() werden zu System-Prompt-Zeilen, die dem Modell die Einheiten beibringen.

3. Das Tool schreiben

typescript

import { InvoicePresenter } from './presenters';

export default f.query('billing.get_invoice')
  .describe('Retrieve an invoice by ID')
  .withString('id', 'Invoice ID')
  .returns(InvoicePresenter)
  .handle(async (input) => {
    return db.invoices.findUnique({
      where: { id: input.id },
    });
  });

f.query() markiert das Tool als nur lesend. Verwenden Sie f.mutation() für Schreibzugriffe und f.action() für alles mit Seiteneffekten. .returns(InvoicePresenter) hängt die Wahrnehmungsschicht an: Der Handler darf die rohe Zeile zurückgeben, die Formung übernimmt der Presenter.

Geben Sie nie PII aus einem Handler ohne angehängten Presenter zurück. Bei MCP Fusion ist der Presenter die Egress-Firewall; ohne ihn geht alles, was der Handler zurückgibt, unverändert an das Modell.

4. Einen Client verbinden

Starten Sie den Dev-Server und verbinden Sie Claude Desktop, Cursor oder einen beliebigen MCP-Client:

bash

mcpfusion dev --server ./src/server.ts
claude mcp add billing npx tsx src/server.ts

Fragen Sie den Client "what is invoice inv_2026_0417?" und sehen Sie zu, wie die Antwort in Dollars zurückkommt, ohne dass die Kunden-E-Mail irgendwo im Transcript auftaucht.

5. Kostenlos deployen

bash

mcpfusion deploy

Ein Befehl bündelt Ihren Server und stellt ihn auf den Vinkius Edge: kostenloses Hosting, keine Kreditkarte. Sie erhalten ein Verbindungstoken und eine MCP-URL wie https://edge.vinkius.com/vk_<token>/mcp. Ihr Connector erscheint in der Vinkius-Konsole wie jeder andere Connector, mit Capabilities, Credentials und Kostenkontrollen, die bereits verdrahtet sind. Den vollständigen Durchgang finden Sie unter Deploy.

Was Sie gebaut haben

Baustein	Rolle
`f.query()`	Ein Nur-Lese-Tool, das der Agent aufrufen kann
`createPresenter()`	Die Wahrnehmungsschicht zwischen Ihren Daten und dem Modell
`.redactPII()`	Die Garantie, dass PII das Modell nie erreicht
`.returns()`	Die Verbindung zwischen Handler und Presenter
`mcpfusion deploy`	Kostenloses Hosting auf dem Vinkius Edge

Nächste Schritte

The MVA pattern: warum es Presenter gibt
Tools: Mutationen, Actions, Middleware und Fehler
Credentials: Käufern erlauben, ihre eigenen Keys zu konfigurieren