---
title: MCP quickstart | Lightfield
description: Connect Claude to your Lightfield workspace using MCP.
---

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

## Claude Web or Desktop

Navigate to [claude.ai](https://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.

Terminal window

```
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](/objects-in-lightfield/object-types/index.md)** — Learn which records are available.
- **[API Reference](/api/index.md)** — Explore the underlying API for accounts, contacts, opportunities, notes, tasks, and more.
- **[Workflows](/workflows/overview/index.md)** — Learn how Lightfield agents and workflows use MCP-connected tools.