MCP quickstart

This guide shows how to connect Claude to your workspace in Lightfield using MCP.

Claude Web or Desktop

Navigate to claude.ai to get started.

Organization setup

An organization admin must add Lightfield as a custom connector before members can use it.

1. Open this link and confirm the prefilled dialog (requires org admin access; not available on personal accounts).
2. Members then go to Settings -> Connectors, find Lightfield, click Connect, and complete the OAuth flow.

Individual setup

For personal accounts (Free, Pro, or Max), or to add Lightfield just for yourself.

1. Open this link and confirm the prefilled dialog.
2. Complete the OAuth flow in the browser window that opens.

Manual setup

If you have difficulty setting up using the links above, add the connector manually:

1. Go to Settings -> Connectors -> Add custom connector.
2. Enter the server URL https://mcp.lightfield.app/mcp and a name (e.g. Lightfield).
3. Save the connector.
4. Complete the OAuth flow in the browser window that opens.

Claude Code

Run the following command in a terminal.

claude mcp add --transport http lightfield https://mcp.lightfield.app/mcp

Then run /mcp in Claude Code, select lightfield, and complete the OAuth flow.

Other MCP clients

Lightfield exposes a Streamable HTTP MCP server with OAuth 2.1 authentication. Any MCP client that supports this transport can connect using the server URL above. If you run into issues, please contact us.

Tools

Once connected, the following tools are available to your MCP client:

Tool	Description
get_current_user	Get your user identity, including name, email, and role.
search_lightfield_api_docs	Browse available API endpoints and resources.
get_lightfield_api_details	Get detailed documentation for a specific API endpoint.
read_from_lightfield	Read data from your Lightfield workspace.
write_to_lightfield	Create or update records in your Lightfield workspace.

Troubleshooting

• Connector not visible in Claude.ai: Add Lightfield yourself with the Individual setup link, or confirm a Claude organization owner has added it org-wide, then check Settings -> Connectors.
• OAuth does not complete: Retry the flow and finish authentication in the browser window that opens.
• Another MCP client not connecting: Ensure the client supports Streamable HTTP transport with OAuth 2.1. If issues persist, contact us.

Next steps

• Objects in Lightfield — Learn which records are available.
• API Reference — Explore the underlying API for accounts, contacts, opportunities, notes, tasks, and more.
• Workflows — Learn how Lightfield agents and workflows use MCP-connected tools.