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 owner setup

The Claude organization owner must add Lightfield as a connector before workspace members can use it.

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.

Workspace member setup

1. Go to Settings -> Connectors.
2. Find Lightfield in the list.
3. Click Connect.
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: Confirm a Claude organization owner has added Lightfield as a custom connector (see above), 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.