Mergi la conținut

API pentru Agenti AI

Integreaza emailfirma in agentul tau AI folosind MCP

MCP (Model Context Protocol)

emailfirma expune un endpoint MCP care permite agentilor AI sa interactioneze direct cu serviciul. Agentul tau poate cauta domenii disponibile, inregistra domenii .ro si proviziona contul — totul programatic.

Endpoint MCP

https://api.emailfirma.ro/mcp

Instaleaza serverul MCP in clientul tau

Autentificarea porneste automat (OAuth 2.1) la prima conectare — nu ai nevoie de chei.

Claude Code

Ruleaza in terminal:

claude mcp add --transport http emailfirma https://api.emailfirma.ro/mcp

Cursor

Instalare cu un clic:

Adauga in Cursor

VS Code

Ruleaza in terminal:

code --add-mcp '{"name":"emailfirma","type":"http","url":"https://api.emailfirma.ro/mcp"}'

Claude.ai / Claude Desktop

Settings → Connectors → Add custom connector, apoi lipeste URL-ul:

https://api.emailfirma.ro/mcp

Configurare manuala (orice alt client)

Adauga in fisierul de configurare MCP:

{
  "mcpServers": {
    "emailfirma": {
      "type": "http",
      "url": "https://api.emailfirma.ro/mcp"
    }
  }
}

Autentificare OAuth 2.1

Nu ai nevoie de chei pre-partajate: la prima conectare clientul MCP porneste automat fluxul OAuth 2.1 — inregistrare dinamica a clientului, autorizare in browser si consimtamant explicit pe scope-uri (citire/scriere pentru domenii, fisiere, workspace si facturare). Detaliile de descoperire sunt publicate la https://api.emailfirma.ro/.well-known/oauth-protected-resource.

Unelte disponibile prin MCP

Agentul tau AI poate apela urmatoarele operatii prin MCP:

Cautare domenii

Verifica disponibilitatea unui domeniu .ro.

search_domain
{ "query": "firma-mea" }

Inregistrare domeniu

Inregistreaza un domeniu .ro pentru un utilizator autentificat.

register_domain
{ "name": "firma-mea.ro", "contact": { ... } }

Provizionare Google Workspace

Creeaza contul Google Workspace pe un domeniu deja inregistrat.

provision_workspace
{ "domainId": "...", "seats": 1 }

Fisiere pentru agenti AI

Urmatoarele fisiere sunt disponibile pentru descoperirea automata a serviciului de catre agenti AI:

Contact

Pentru intrebari despre integrarea MCP, contacteaza-ne la [email protected].