Przejdź do głównej zawartości
PlaidCloud

Połącz agenta kodowania AI

Ten samouczek pokazuje, jak skonfigurować agenta kodowania AI do pracy z Twoim obszarem roboczym PlaidCloud za pomocą Model Context Protocol (MCP). Po skonfigurowaniu możesz prosić agenta o odczyt tabel, uruchamianie przepływów pracy, budowanie alokacji i odpowiadanie na pytania o dane — bezpośrednio z edytora.

Zajmuje około 20 minut. Działa z Claude Code, Cursor, Claude Desktop, ChatGPT, GitHub Copilot i dowolnym klientem zgodnym z MCP.

Co zbudujesz

Dział zatytułowany „Co zbudujesz”

Działające połączenie między agentem kodowania AI a Twoim obszarem roboczym PlaidCloud, dzięki któremu agent może:

  • wyświetlać projekty, tabele, przepływy pracy i wymiary,
  • odczytywać zawartość tabel,
  • przeglądać definicje przepływów pracy,
  • wyzwalać uruchomienia przepływów pracy,
  • odpowiadać na pytania o Twoje dane bez przełączania kontekstu.

Wymagania wstępne

Dział zatytułowany „Wymagania wstępne”
  • Obszar roboczy PlaidCloud (rozpocznij bezpłatny okres próbny, jeśli go nie masz)
  • Agent kodowania AI, którego już używasz — Claude Code, Cursor, Claude Desktop, ChatGPT, Copilot lub Gemini
  • Agent musi obsługiwać MCP (większość obecnych narzędzi AI to robi)

Krok 1: znajdź adres URL MCP swojego obszaru roboczego

Dział zatytułowany „Krok 1: znajdź adres URL MCP swojego obszaru roboczego”

Każdy obszar roboczy PlaidCloud udostępnia punkt końcowy MCP pod adresem:

https://<your-workspace>.plaid.cloud/mcp

Zastąp <your-workspace> poddomeną swojego obszaru roboczego — tą samą, której używasz do logowania się w interfejsie PlaidCloud.

Krok 2: uzyskaj token uwierzytelniania

Dział zatytułowany „Krok 2: uzyskaj token uwierzytelniania”
  1. Po zalogowaniu się do PlaidCloud w przeglądarce odwiedź: 
    https://<your-workspace>.plaid.cloud/mcp/setup/token
  2. Skopiuj token okaziciela wyświetlony na stronie. Przechowuj go bezpiecznie — daje taki sam dostęp, jaki ma Twoje konto.

Krok 3: skonfiguruj agenta

Dział zatytułowany „Krok 3: skonfiguruj agenta”

Uruchom w terminalu:

Okno terminala
claude mcp add --transport http plaidcloud https://<your-workspace>.plaid.cloud/mcp

Aby użyć uwierzytelniania statycznym tokenem (bez przepływu OAuth, prostsze przy długich sesjach), otwórz w przeglądarce adres URL z kroku 2, skopiuj wyświetlony fragment konfiguracji i wklej go do pliku .mcp.json.

Zobacz konfigurację Claude Code, aby poznać wszystkie opcje.

Krok 4: zweryfikuj połączenie

Dział zatytułowany „Krok 4: zweryfikuj połączenie”

Zadaj agentowi proste pytanie:

„Wyświetl projekty w moim obszarze roboczym PlaidCloud.”

Agent powinien odpowiedzieć listą Twoich projektów. Jeśli tak się nie stanie, skorzystaj z poniższych wskazówek dotyczących rozwiązywania problemów.

Krok 5: wypróbuj prawdziwe zadania

Dział zatytułowany „Krok 5: wypróbuj prawdziwe zadania”

Po połączeniu spróbuj:

  • Poznaj swoje dane: „Jakie kolumny ma tabela sales w moim projekcie Quickstart?”
  • Uruchom przepływ pracy: „Uruchom przepływ pracy monthly_close w projekcie Financials i daj mi znać, kiedy się zakończy.”
  • Zbuduj coś: „Utwórz krok Table Lookup w moim przepływie pracy Test, który filtruje zamówienia z ostatnich 30 dni.”

Odpowiedzi agenta będą oparte na rzeczywistym stanie Twojego obszaru roboczego, a nie na ogólnikach.

Rozwiązywanie problemów

Dział zatytułowany „Rozwiązywanie problemów”

Jeśli agent nie może połączyć się z PlaidCloud lub zwraca błędy uwierzytelniania:

  • Token wygasł — odśwież go pod adresem https://<your-workspace>.plaid.cloud/mcp/setup/token
  • Nieprawidłowe zakresy — niektóre narzędzia wymagają określonych zakresów PlaidCloud (np. analyze.workflow.write). Uruchom w agencie mcp_introspect(name='<tool>'), aby zobaczyć wymagane zakresy
  • Nieprawidłowa poddomena obszaru roboczego — potwierdź ją, logując się do interfejsu PlaidCloud; poddomena to część przed .plaid.cloud

Więcej informacji znajdziesz w rozwiązywaniu problemów z agentami kodowania AI.

Co dalej

Dział zatytułowany „Co dalej”