How to Use Claude Code for Salesforce Apex Development (Build an Enrichment Callout)

export LEADOCEAN_API_KEY="paste-your-key-here"
sf org list

Apex rules for this repo:
- API version 62.0. One trigger per object, logic in handler classes.
- No SOQL or DML inside loops. Bulkify everything.
- Callouts only through a Named Credential called LeadOcean. Never a literal key.
- Triggers cannot call out directly. Use Queueable with Database.AllowsCallouts.
- Every class needs a test with HttpCalloutMock and 90%+ coverage.
- Run `sf apex run test --code-coverage --result-format human` before saying done.
- Deploy only to the scratch org alias `dev`. Never to production.

claude mcp add --transport http --scope user leadocean https://api.leadocean.io/mcp
claude mcp login leadocean

Use the LeadOcean MCP server only. Call leadocean_count_leads with
title ["Salesforce Developer"] and country ["US"]. Report total, totalAll and
distinctCompanies, and say which email statuses the total counted. Do not pull anyone.

Create force-app/main/default/classes/LeadEnrichQueueable.cls.
- Implements Queueable, Database.AllowsCallouts. Takes a List<Id> of Leads.
- For each Lead with an email, POST to callout:LeadOcean/v1/people/enrich
  with body {"email": <email>}. One call per Lead.
- On 200, write data.contact_data.contact_current_experiences[0].job_title
  into Lead.Title only if Title is blank.
- On 404, do nothing. On 429, re-enqueue once. Log other codes with System.debug.
- Process at most 50 Leads per job. Add a LeadTrigger handler that enqueues it.
Then write the test class with an HttpCalloutMock. Do not deploy yet.

public with sharing class LeadEnrichQueueable implements Queueable, Database.AllowsCallouts {
    private List<Id> leadIds;
    public LeadEnrichQueueable(List<Id> leadIds) { this.leadIds = leadIds; }

    public void execute(QueueableContext ctx) {
        List<Lead> leads = [SELECT Id, Email, Title FROM Lead WHERE Id IN :leadIds];
        List<Lead> toUpdate = new List<Lead>();
        for (Lead l : leads) {
            if (String.isBlank(l.Email)) continue;
            HttpRequest req = new HttpRequest();
            req.setEndpoint('callout:LeadOcean/v1/people/enrich');
            req.setMethod('POST');
            req.setHeader('content-type', 'application/json');
            req.setBody(JSON.serialize(new Map<String, String>{ 'email' => l.Email }));
            HttpResponse res = new Http().send(req);
            if (res.getStatusCode() == 200 && String.isBlank(l.Title)) {
                Map<String, Object> body = (Map<String, Object>) JSON.deserializeUntyped(res.getBody());
                Map<String, Object> data = (Map<String, Object>) body.get('data');
                Map<String, Object> contact = (Map<String, Object>) data?.get('contact_data');
                List<Object> roles = (List<Object>) contact?.get('contact_current_experiences');
                if (roles != null && !roles.isEmpty()) {
                    Map<String, Object> role = (Map<String, Object>) roles[0];
                    if (role.get('job_title') != null) {
                        l.Title = (String) role.get('job_title');
                        toUpdate.add(l);
                    }
                }
            }
        }
        if (!toUpdate.isEmpty()) update toUpdate;
    }
}

sf project deploy start --target-org dev
sf apex run test --target-org dev --code-coverage --result-format human --wait 10

curl -s https://api.leadocean.io/v1/people/enrich \
  -H "x-api-key: $LEADOCEAN_API_KEY" -H "content-type: application/json" \
  -d '{"email": "jane.doe@acme.com"}' | jq 'keys, (.data | keys)'

{
  "total": 3563,
  "totalIsExact": true,
  "totalAll": 13143,
  "distinctCompanies": 1788,
  "credits": 0,
  "defaults": "Counted only addresses worth sending to (emailStatus: verified or catch_all_valid or catch_all)",
  "unsupportedFilters": []
}

{
  "success": true,
  "data": {
    "profile_data": { "profile_full_name": "Jane Doe" },
    "contact_data": {
      "has_email": true,
      "email_status": "verified",
      "contact_current_experiences": [
        { "company_name": "Acme", "company_domain": "acme.com", "job_title": "Salesforce Developer" }
      ]
    },
    "resume_data": { "experiences": [] }
  },
  "meta": { "credits": 1 }
}