Anleitung · Framework

Formfeed in Claude API

Es gibt zwei Wege, Claude die Formfeed-Werkzeuge über die Messages API zu geben. Das Python-SDK kann die Werkzeuge eines lokalen MCP-Servers für seinen Tool Runner einbinden, das funktioniert jetzt. Der MCP-Connector lässt die API einen entfernten Server selbst aufrufen; dafür braucht es den HTTP-Endpunkt.

1. 1

   Test-Schlüssel anlegen

   Melden Sie sich in der App an, öffnen Sie API-Schlüssel und legen Sie einen Schlüssel in der Testumgebung an. Testrenderings werden nicht berechnet, genau richtig, solange ein Agent Ihre Vorlagen noch kennenlernt. Für den Produktivbetrieb wechseln Sie auf einen Live-Schlüssel.

2. 2

   Pakete installieren

   pip install "anthropic[mcp]"

3. 3

   Den Formfeed-Server hinzufügen

   Beim Connector braucht jeder Server in mcp_servers einen passenden mcp_toolset-Eintrag in tools und die Beta mcp-client-2025-11-20.

   Lokaler Server (Tool Runner)

   agent.pyPython

   import asyncio
   import os
   
   from anthropic import AsyncAnthropic
   from anthropic.lib.tools.mcp import async_mcp_tool
   from mcp import ClientSession
   from mcp.client.stdio import StdioServerParameters, stdio_client
   
   formfeed = StdioServerParameters(
       command="npx",
       args=["-y", "@formfeed/mcp"],
       env={"FORMFEED_API_KEY": os.environ["FORMFEED_API_KEY"]},
   )
   prompt = "Render the certificate for Jane Doe, course Analytical Engines 101."
   
   
   async def main() -> None:
       client = AsyncAnthropic()
       async with stdio_client(formfeed) as (read, write):
           async with ClientSession(read, write) as session:
               await session.initialize()
               tools = (await session.list_tools()).tools
               runner = client.beta.messages.tool_runner(
                   model="claude-opus-5-5",
                   max_tokens=16000,
                   tools=[async_mcp_tool(t, session) for t in tools],
                   messages=[{"role": "user", "content": prompt}],
               )
               async for message in runner:
                   print(message.content)
   
   
   asyncio.run(main())

   MCP-Connector (remote)

   agent.pyPython

   import os
   
   import anthropic
   
   client = anthropic.Anthropic()
   
   response = client.beta.messages.create(
       model="claude-opus-5-5",
       max_tokens=16000,
       betas=["mcp-client-2025-11-20"],
       mcp_servers=[
           {
               "type": "url",
               "url": "https://mcp.formfeed.dev/mcp",
               "name": "formfeed",
               "authorization_token": os.environ["FORMFEED_API_KEY"],
           }
       ],
       tools=[{"type": "mcp_toolset", "mcp_server_name": "formfeed"}],
       messages=[{"role": "user", "content": "Which Formfeed templates can render an invoice?"}],
   )
   
   for block in response.content:
       if block.type == "text":
           print(block.text)

   Anmeldung statt Schlüssel: Verbinden Sie https://mcp.formfeed.dev/mcp ohne Header, und der Client öffnet die Formfeed-Anmeldung, in der Sie den Workspace des Agenten wählen. Ein angemeldeter Agent rendert immer live und verbraucht Einheiten; kostenlose Testrenderings gibt es nur mit einem Test-Schlüssel. Ein selbst betriebener Endpunkt (npx -y @formfeed/mcp --http) nimmt nur API-Schlüssel.

4. 4

   Verbindung prüfen

   Mit dem Tool Runner liefert jede Runde eine Nachricht; die tool_use-Blöcke zeigen, welches Formfeed-Werkzeug mit welcher Eingabe lief.