Was macht affinity-sdk?
Inoffizielles, stark typisiertes Python SDK für die Affinity CRM API – vollständige Lese-/Schreibabdeckung, Pydantic v2, inklusive MCP-Server. Für wenn du mehr brauchst als Affinitys offizielles MCP.
Installation
pip install affinity-sdk
Schnellstart
from affinity_sdk import AffinityClient
from affinity_sdk.models import Contact, Organization
# Client initialisieren
client = AffinityClient(api_key="dein-api-schlüssel")
# Kontakt abrufen
contact = client.contacts.get(contact_id=12345)
print(contact.name) # Beispiel: "Max Mustermann"
# Neuen Kontakt erstellen
new_contact = client.contacts.create(
name="Erika Musterfrau",
emails=["[email protected]"],
organization_ids=[67890]
)
MCP-Server verwenden
Der SDK enthält einen eingebauten MCP-Server, der mit KI-Agenten genutzt werden kann:
# MCP-Server starten
affinity-mcp --api-key "dein-api-schlüssel"
Oder in der Konfiguration deines AI-Agenten:
{
"mcpServers": {
"affinity": {
"command": "affinity-mcp",
"args": ["--api-key", "dein-api-schlüssel"]
}
}
}
Dokumentation
Vollständige Dokumentation findest du unter docs.yaniv-golan.dev/affinity-sdk.
Lizenz
MIT