Cum conectezi Claude Code la fanTask prin MCP: Ghid pas cu pas

Ce este Model Context Protocol (MCP) și de ce contează?

Model Context Protocol (MCP) este un standard deschis dezvoltat pentru a permite modelelor de limbaj și asistenților de programare să comunice în mod securizat și direct cu instrumente externe, baze de date și servicii specializate. În loc ca asistentul tău AI să fie limitat la fișierele locale din directorul curent sau să depindă de copierea manuală a datelor dintr-un tab de browser în altul, MCP îi oferă agentului un mecanism nativ prin care poate interoga și actualiza sisteme externe în timpul execuției.

De ce să conectezi Claude Code la fanTask?

Claude Code este un instrument formidabil pentru dezvoltarea de software în terminal, însă suferă de aceeași constrângere a oricărui asistent AI modern: contextul conversațional se resetează la pornirea unei noi sesiuni sau este compactat agresiv pe măsură ce firul de discuție devine lung.

fanTask funcționează ca un strat extern de memorie și coordonare de proiect pentru agenții AI. Conectat prin MCP la fanTask, Claude Code nu mai lucrează în orb:

• Citește automat convențiile de arhitectură și regulile proiectului (prin câmpul persistent AI Context) înainte de a scrie cod.
• Caută în istoricul de tichete și comentarii pentru a vedea cum au fost rezolvate bug-uri similare în trecut.
• Primește și actualizează task-uri direct pe board-ul comun pe care îl împarți cu el, menținând transparența completă.

Pasul 1: Obține tokenul de acces din fanTask

Dacă tocmai ți-ai creat contul, fanTask îți arată automat, direct pe pagina spațiului de lucru, un modal „Connect your AI to fanTask” cu mai multe opțiuni (Claude, Gemini CLI / Antigravity, ChatGPT, Gemini App, Other). Selectează Claude — platforma generează pe loc, automat, un token personal de acces și un prompt complet, gata de copiat, pe care îl lipești direct într-o conversație Claude Code sau Claude Desktop.

Dacă ai închis acel modal sau te-ai autentificat cu un cont mai vechi, poți relua oricând pasul de conectare din meniul spațiului tău de lucru: Workspace → MCP / AI. Acolo găsești aceleași opțiuni și același prompt gata de copiat, generat cu tokenul tău curent.

Pasul 2: Înregistrează serverul fanTask în Claude Code

Cel mai simplu mod de a te conecta este să lipești promptul de la Pasul 1 direct într-o conversație Claude Code — acesta include deja comanda de înregistrare cu tokenul tău completat, iar Claude o rulează singur. Dacă preferi să rulezi comanda manual în terminal, ea are exact această formă:

claude mcp add fantask --transport http https://api.fantask.ro/mcp --header "Authorization: Bearer TOKENUL_TAU_FANTASK" -s user

Înlocuiește TOKENUL_TAU_FANTASK cu tokenul din Pasul 1. Comanda înregistrează serverul MCP fantask la nivel de utilizator (-s user, disponibil apoi în toate proiectele tale Claude Code), cu antetul HTTP de autorizare necesar, direcționat către endpoint-ul de producție https://api.fantask.ro/mcp.

Pasul 3: Verifică uneltele disponibile

După repornirea Claude Code în proiectul tău, agentul va detecta automat conexiunea la fanTask și va avea acces la setul complet de unelte MCP expuse de platformă:

• fantask.get_project_context(project_id): Încarcă documentul viu cu regulile de arhitectură, convențiile de denumire, bibliotecile permise și capcanele cunoscute ale proiectului.
• fantask.search_tasks(query, filters): Caută în istoricul complet de tichete, rezolvări și comentarii ale echipei tale folosind cuvinte-cheie sau căutare semantică.
• fantask.get_task(task_id): Preia detaliile complete, cerințele și comentariile asociate unui anumit task.
• fantask.update_task(task_id, status, comment): Schimbă statusul unui task (de exemplu, trece un tichet din todo în in_progress sau in_review) și adaugă note explicative.
• fantask.create_task(project_id, title, description, priority): Deschide un task nou pe board atunci când agentul identifică un bug secundar sau o sarcină de refactorizare ce merită urmărită separat.
• fantask.add_comment(task_id, message): Postează un rezumat tehnic al modificărilor efectuate, menționând fișierele și liniile atinse pentru un audit trail complet.

Fluxul de lucru recomandat

Odată conectat, modul în care lucrezi cu Claude Code devine mult mai ordonat și predictibil:

1. La începutul sesiunii: Îi poți cere lui Claude: „Verifică AI Context-ul proiectului în fanTask și afișează task-urile active.” Claude apelează get_project_context și search_tasks, aliniindu-se imediat la regulile tale fără să fie nevoie să le re-explici.
2. În timpul implementării: Când Claude începe lucrul pe o sarcină, apelează update_task pentru a marca statusul in_progress. Dacă se lovește de un comportament neașteptat, caută cu search_tasks dacă soluția a mai fost documentată.
3. La finalizarea modificărilor: După ce codul a fost testat, Claude mută tichetul în in_review și lasă un comentariu structurat prin add_comment. Tu verifici modificările în interfața fanTask sau în git diff și marchezi task-ul ca done.

Începe gratuit

Planul gratuit fanTask îți oferă un proiect complet funcțional, până la 3 membri și acces nelimitat la uneltele MCP descrise mai sus. Încearcă integrarea și experimentează diferența unui agent AI care are memorie pe termen lung.

Creează cont gratuit pe fanTask și conectează Claude Code →