Zusammenfassung
USPS APIs für Versender: US-Adressen validieren und ZIP-Codes nachschlagen, nationale und internationale Preise vergleichen, Lieferzeiten und Versandoptionen abrufen, Pakete verfolgen und Postämter, Abgabestellen und Paketfächer finden. Etiketten, Rückerstattungen, Abholungen und SCAN-Formulare sind enthalten, aber deaktiviert. Consumer Key und Secret einer App im USPS Customer Onboarding Portal.
Geführte Einrichtung
USPS in 2 Minuten mit Microsoft Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde USPS in der geführten Einrichtung und trag deine MCP-URL in Microsoft Copilot ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für USPS
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → USPS, füge deine Zugangsdaten ein, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
USPS + Microsoft Copilot
USPS APIs für Versender: US-Adressen validieren und ZIP-Codes nachschlagen, nationale und internationale Preise vergleichen, Lieferzeiten und Versandoptionen abrufen, Pakete verfolgen und Postämter, Abgabestellen und Paketfächer finden. Etiketten, Rückerstattungen, Abholungen und SCAN-Formulare sind enthalten, aber deaktiviert. Consumer Key und Secret einer App im USPS Customer Onboarding Portal.
Voraussetzungen
Siehe die vollständigen Einrichtungsanweisungen, die im Connector integriert sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:
USPS_CLIENT_ID, USPS_CLIENT_SECRET, USPS_API_HOST
Schritt 1 — Zugangsdaten abrufen
Die Einrichtung dauert etwa 15 Minuten.
- Öffne das USPS Customer Onboarding Portal unter https://cop.usps.com/cop-navigator?wf=API und melde dich mit deinem USPS Business Account an oder erstelle dort einen. Das Portal bereitet das Konto für die USPS APIs vor.
- Wähle Meine Apps oben im Portal und füge eine App hinzu.
- Öffne die App. Kopiere in Zugangsdaten den Consumer Key in
USPS_CLIENT_IDund das Consumer Secret inUSPS_CLIENT_SECRET. - Wähle die API-Adresse in
USPS_API_HOST: Produktionhttps://apis.usps.comoder die Testumgebung für Versenderhttps://apis-tem.usps.com. Beide verwenden die gleichen Produktions-Zugangsdaten. Etiketten, die auf dem Test-Host erstellt werden, sind mit Wasserzeichen versehen und werden nie berechnet. USPS veröffentlicht den Test-Host für jede API außer Tracking, also bleibe bei der Produktion, wenn du hauptsächlich verfolgst. - Optional, für Etiketten und Vertragspreise: deine CRID, Mailer ID und Enterprise Payment Account-Nummer in
USPS_CRID,USPS_MIDundUSPS_EPS_ACCOUNT_NUMBER. Der Business Service Administrator deines Business Customer Gateway-Kontos hat diese.
Der Connector sendet den Consumer Key und das Secret an /oauth2/v3/token auf dem gewählten Host (Client-Zugangsdaten) und erhält ein Bearer-Token, das etwa 8 Stunden gültig ist, welches er selbst wiederverwendet und erneuert.
Was eine neue App verwenden kann: jede App beginnt mit dem USPS-Standardprodukt: OAuth, Adressen, nationale Preise, internationale Preise, Standorte, Service-Standards, Versandoptionen und Tracking. Adressen, Preise, Lieferzeiten, Versandoptionen, Tracking, Postämter und Abgabestellen funktionieren daher sofort. Carrier Pickup, Zahlungen, Etiketten und SCAN-Formulare benötigen die Genehmigung von USPS: frage danach mit einer USPS API-Serviceanfrage auf der Seite „Email Us“ (https://emailus.usps.com/s/usps-APIs). Die Etiketten-APIs benötigen auch eine Anmeldung bei USPS Ship (ausgehende und Rücksendungen) und ein Enterprise Payment Account (EPS), das das Porto bezahlt. Paketfächer (usps_find_parcel_lockers) und der internationale Service-Standard (usps_get_international_service_standard) haben eigene Berechtigungen; wenn sie mit 403 antworten, frage USPS auf die gleiche Weise danach.
Wo du anfangen kannst: usps_get_city_state mit einer ZIP-Code beweist die Verbindung. Für ein Angebot gibt usps_search_shipping_options Preise und Lieferdaten für jeden Service in einem Aufruf zurück; usps_search_domestic_prices und usps_search_international_prices geben die Preisaufschlüsselung mit zusätzlichen Services.
Adressen: usps_validate_address standardisiert eine US-Adresse und gibt die ZIP+4, DPVConfirmation (Y bestätigt, D sekundäre Nummer fehlt, S sekundäre Nummer nicht bestätigt, N nicht bestätigt), business (Y oder N) und vacant zurück. usps_get_zip_code findet die ZIP-Code einer Straße in einer Stadt und einem Bundesstaat, usps_get_city_state die Stadt und den Bundesstaat eines ZIP-Codes. Bundesstaaten sind zweibuchstabige Codes; nur US-Adressen (einschließlich Territorien und militärischer Adressen) sind abgedeckt.
Preise: Pakete werden in Pfund gewogen und in Zoll gemessen; Briefe, Flats und Karten werden in Unzen gewogen. price_type COMMERCIAL ist das, was du für online gekaufte Etiketten zahlst, RETAIL ist der Preis am Postschalter, CONTRACT benötigt account_type und account_number. usps_search_domestic_prices gibt rateOptions mit totalBasePrice, totalPrice und den zusätzlichen Services zurück; usps_list_domestic_prices listet jedes berechtigte Produkt mit seiner SKU, rateIndicator und processingCategory, die Werte, die eine Etikettenanfrage benötigt. usps_search_letter_prices bepreist First-Class Mail-Briefe, Flats und Postkarten. Im Ausland: usps_search_international_prices (optional mit Zöllen und Steuern pro Artikel), usps_list_international_prices und usps_search_international_letter_prices. Versanddaten können heute bis zu 7 Tage im Voraus sein. Beträge sind in US-Dollar. USPS_GROUND_ADVANTAGE hat den First-Class Package Service und Retail Ground ersetzt.
Lieferzeiten: usps_get_delivery_estimates gibt das geplante Lieferdatum für einen Versandtag an, mit der Annahmeschlusszeit (cutOffTime, HHMM lokal); usps_get_service_standards die Standardanzahl von Tagen pro Postklasse; usps_get_international_service_standard einen Satz wie Geschätzte Lieferung in 5-9 Werktagen. Ein Service-Standard ist ein Ziel, keine Garantie.
Tracking: usps_track_package für eine Nummer, usps_track_packages für bis zu 35 auf einmal. Beide verwenden Tracking 3.2; die veraltete Tracking 3.0 API wird am 31. Juli 2027 eingestellt. Die Antwort hat statusCategory, statusSummary, trackingEvents (eventTimestamp in lokaler Zeit des Ereignisses, GMTTimestamp in UTC), deliveryDateExpectation und uniqueTrackingID. Eine Batch-Antwort gibt HTTP 207 zurück, wenn einige Nummern fehlschlagen, und jede fehlgeschlagene Nummer trägt ihren eigenen error. usps_register_tracking_notifications meldet bis zu 3 E-Mail-Adressen für Tracking-E-Mails an und usps_request_proof_of_delivery hat einen Zustellnachweisbrief, der per E-Mail versendet wird; beide benötigen die uniqueTrackingID einer Tracking-Antwort, senden E-Mails von USPS und kosten nichts.
Standorte: usps_find_post_offices sucht nach ZIP-Code, Stadt und Bundesstaat, Adresse oder Koordinaten (Radius in Meilen, standardmäßig 20) und listet die Öffnungszeiten jedes Services auf; usps_find_dropoff_locations listet die Zielabgabestellen für Parcel Select, USPS Connect und Paketdienste nach Ziel-ZIP-Code auf; usps_find_parcel_lockers findet Paketfächer.
Abholungen: usps_check_pickup_eligibility und usps_get_pickup sind nur lesend. usps_schedule_pickup bucht die kostenlose Carrier Pickup (Montag bis Samstag) und usps_cancel_pickup storniert eine; beide sind deaktiviert. Eine Abholung kann hier nicht geändert werden: storniere sie und buche eine neue.
Etiketten (deaktiviert): jeder Etikettenaufruf benötigt ein Zahlungsgenehmigungstoken. usps_create_payment_authorization mit deiner CRID, Mailer ID und EPS-Konto gibt paymentAuthorizationToken zurück; übergebe es an usps_create_label, usps_create_return_label, usps_create_international_label, usps_cancel_label oder usps_cancel_international_label. Etiketten kommen als JSON zurück: labelMetadata mit der Sendungsverfolgungsnummer und dem Porto sowie labelImage in base64 (standardmäßig ein 4x6 PDF). Das Erstellen eines Etiketts kauft Porto vom EPS-Konto. Eine Stornierung antwortet mit CANCELED oder DISPUTED mit einer disputeId, wenn USPS eine Rückerstattungsanfrage eröffnet hat. usps_get_payment_account liest das Konto und sagt mit amount, ob die Mittel ausreichen. usps_create_scan_form platziert viele Etiketten auf einem PS Form 5630 für einen einzigen Annahmescan. Schalte diese Tools erst ein, nachdem USPS die Etiketten-APIs genehmigt hat, und teste sie zuerst auf dem Test-Host.
Fehler: Fehler kommen als error mit code, message und einer Liste errors (title, detail, source.parameter). 400 benennt das falsche Feld; 401 bedeutet falsche Zugangsdaten oder ein abgelaufenes Token; 403 bedeutet, dass die App diese API nicht hat (sie liegt außerhalb des Standardprodukts); 404 bedeutet, dass USPS nichts gefunden hat, z.B. eine unbekannte Sendungsverfolgungsnummer.
Limits: jede App hat eine Quote von Anrufen pro Stunde; ein 429 bedeutet, dass sie bis zur nächsten Stunde aufgebraucht ist. USPS erhöht die Quote auf Anfrage über die Seite „Email Us“. Daten sind im Format YYYY-MM-DD.
Schritt 2 — Adapter installieren
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Schritt 3 — Connector in Microsoft Copilot hinzufügen
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.
- Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
- Trag einen Server name ein (zum Beispiel
AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft. - Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf
X-API-Keyund klicke auf Create. - Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
- Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die
USPS-Tools braucht. - Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.
Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.
Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
usps_validate_address | Validiert und standardisiert eine US-Adresse. Gibt address in USPS-Standardform zurück (streetAddress, city, state, ZIPCode, ZIPPlus4)… |
usps_get_city_state | Schlägt die Stadt und den Bundesstaat eines 5-stelligen ZIP-Codes nach. Gibt city (in Großbuchstaben), state (zwei Buchstaben) und ZIPCode zurück. Günstiger Aufruf, verwendet als… |
usps_get_zip_code | Findet den ZIP-Code und ZIP+4 einer Straßenadresse in einer Stadt und einem Bundesstaat. Gibt address mit der standardisierten Straße, city, state… zurück |
usps_search_domestic_prices | Bepreist ein nationales Paket über Postklassen, zusätzliche Services inklusive. Gibt rateOptions zurück, eine pro berechtigtem Produkt, jedes mit… |
usps_list_domestic_prices | Listet jedes Produkt auf, für das ein nationales Paket berechtigt ist, mit seinem Basispreis und ohne zusätzliche Services. Gibt rateOptions mit… zurück |
usps_search_letter_prices | Bepreist einen First-Class Mail-Brief, Flat (großes Kuvert) oder Postkarte, die innerhalb der USA versendet wird. Gibt totalBasePrice und rates (SKU… zurück |
usps_search_international_prices | Bepreist ein ausgehendes internationales Paket, zusätzliche Services inklusive und auf Anfrage, Zölle und Steuern pro Artikel. Gibt rateOptions zurück, eine pro… |
usps_list_international_prices | Listet jedes internationale Produkt auf, für das ein ausgehendes Paket berechtigt ist, mit Basispreisen und ohne zusätzliche Services. Gibt rateOptions mit… zurück |
usps_search_international_letter_prices | Bepreist einen First-Class Mail International-Brief, Flat oder Postkarte. Gibt totalBasePrice, rates (SKU, description, price, fees)… zurück |
usps_get_delivery_estimates | Schätzt das Lieferdatum von Post, die an einem bestimmten Tag angenommen wurde. Gibt eine Liste zurück, einen Eintrag pro Postklasse, mit serviceStandard (Tage)… |
usps_get_service_standards | Gibt die standardmäßige Anzahl von Liefer Tagen zwischen zwei ZIP-Codes pro Postklasse zurück. Gibt eine Liste mit mailClass, days… zurück |
usps_get_international_service_standard | Gibt die erwartete Lieferzeit einer internationalen Postklasse an ein Land zurück. Gibt countryCode, mailClass und… zurück |
usps_search_shipping_options | Vergleicht jede Möglichkeit, ein Paket in einem einzigen Aufruf zu versenden: Preise und Lieferverpflichtungen zusammen, national oder international. Gibt… zurück |
usps_track_package | Verfolgt ein USPS-Paket mit Tracking 3.2. Gibt trackingNumber, uniqueTrackingID, mailClass, status, statusCategory (z.B.… zurück |
usps_track_packages | Verfolgt bis zu 35 USPS-Pakete in einem Aufruf mit Tracking 3.2. Gibt ein Ergebnis pro Nummer mit trackingNumber, uniqueTrackingID… zurück |
usps_register_tracking_notifications | Meldet bis zu 3 E-Mail-Adressen für USPS-Tracking-E-Mails zu einem Paket an: erwartete Lieferupdates, Lieferaktivitäten oder alle Updates. Benötigt… |
usps_request_proof_of_delivery | Lässt USPS einen Zustellnachweisbrief (oder einen elektronischen Rückschein) für ein zugestelltes Paket an bis zu 3 Empfänger per E-Mail senden. Benötigt die… |
usps_find_post_offices | Findet Postämter und andere Einzelhandelsstandorte in der Nähe eines ZIP-Codes, einer Adresse oder Koordinaten, am nächsten zuerst. Gibt locations mit… zurück |
usps_find_dropoff_locations | Findet die Zielabgabestellen, an denen du Post für Parcel Select, USPS Connect und Paketdienste für einen Ziel-ZIP-Code abgeben kannst… |
usps_find_parcel_lockers | Findet USPS-Paketfächer nach ZIP-Code oder nach Stadt und Bundesstaat. Gibt eine Liste von Fächern mit facilityID, locationName, locationAddress… zurück |
usps_check_pickup_eligibility | Überprüft, ob USPS kostenlose Carrier Pickup an einer Adresse anbietet. Antwortet mit 200, wenn die Adresse in standardisierter Form vorliegt… |
usps_get_pickup | Holt eine geplante Carrier Pickup mit der Bestätigungsnummer ab. Gibt confirmationNumber, pickupDate und carrierPickupRequest (Adresse… zurück |
usps_get_payment_account | Überprüft ein Enterprise Payment Account oder eine Genehmigung. Gibt die Kontodetails zurück und sagt, wenn amount angegeben ist, sufficientFunds (wahr oder falsch)… |
usps_create_payment_authorization | Holt das Zahlungsgenehmigungstoken, das jeder Etikettenaufruf benötigt: benennt dein Unternehmen als PAYER und LABEL_OWNER mit seiner CRID, Mailer ID und… |
usps_create_label | Kauft Porto und erstellt ein nationales Versandetikett, das aus dem Enterprise Payment Account im Zahlungsgenehmigungstoken bezahlt wird. Gibt… zurück |
usps_create_return_label | Erstellt ein nationales Rücksendeetikett für einen Kunden, um ein Paket zurückzusenden (to_address ist deine Rücksendeadresse, from_address der Kunde).… |
usps_cancel_label | Storniert ein ungenutztes nationales Etikett oder beantragt eine Porto-Rückerstattung. Gibt trackingNumber, status (CANCELED oder DISPUTED, wenn eine Rückerstattung… zurück |
usps_create_international_label | Kauft Porto und erstellt ein internationales Etikett mit seinem Zollformular (First-Class Package International Service, Priority Mail International… |
usps_cancel_international_label | Storniert ein ungenutztes internationales Etikett oder beantragt eine Porto-Rückerstattung. Gibt die Sendungsverfolgungsnummer, status (CANCELED oder DISPUTED) und die… zurück |
usps_schedule_pickup | Bucht eine kostenlose USPS Carrier Pickup für Pakete an deiner Adresse (Montag bis Samstag; nur am selben Tag bis 2 Uhr Central Time). Gibt… zurück |
usps_cancel_pickup | Storniert eine geplante Carrier Pickup mit der Bestätigungsnummer. Gibt 200 zurück, wenn sie storniert wurde. Installiert deaktiviert: Stornierungen bleiben bei einem… |
usps_create_scan_form | Erstellt ein SCAN-Formular (PS Form 5630), das Etiketten mit einem Barcode verknüpft, sodass ein einzelner Scan bei der Annahme jedes Paket aufzeichnet. Gibt… zurück |
Beispielaufforderungen
- "Wo ist das USPS-Paket 9400111899223197428490?"
- "Ist 1600 Pennsylvania Ave NW, Washington DC 20500 eine gültige Adresse, und was ist ihre ZIP+4?"
- "Vergleiche die USPS-Preise und Lieferdaten für ein 3 lb Paket von 10001 nach 94105, das morgen versendet wird."
- "Was kostet ein 2 lb Paket nach Toronto mit USPS Priority Mail International?"
- "Finde Postämter, die am Samstag in der Nähe von ZIP 60614 geöffnet sind."
FAQ
Woher kommen die USPS-Zugangsdaten? Von einer App im USPS Customer Onboarding Portal (cop.usps.com), angemeldet mit deinem USPS Business Account: öffne Meine Apps, füge eine App hinzu und kopiere ihren Consumer Key und Consumer Secret. Wähle den Produktions-Host oder die Testumgebung für Versender; beide verwenden die gleichen Zugangsdaten.
Was funktioniert sofort und was benötigt die Genehmigung von USPS? Adressen, Preise, Lieferzeiten, Versandoptionen, Tracking und Standorte funktionieren mit jeder neuen App. Carrier Pickup, Zahlungen, Etiketten und SCAN-Formulare benötigen die Genehmigung von USPS durch eine USPS API-Serviceanfrage; Etiketten benötigen auch USPS Ship und ein Enterprise Payment Account.
Welche Tools sind deaktiviert installiert? Die Tools, die kaufen oder buchen: usps_create_payment_authorization, usps_create_label, usps_create_return_label, usps_cancel_label, usps_create_international_label, usps_cancel_international_label, usps_schedule_pickup, usps_cancel_pickup und usps_create_scan_form. Schalte sie auf der Connector-Seite ein, sobald USPS sie genehmigt hat und die KI sie verwenden sollte.
Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.
Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.
Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.
Nächste Schritte
War dieser Guide hilfreich?