Skip to main content

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: Basic auth.
  • Connection: HTTP Basic auth with LANGFUSE_PUBLIC_KEY as the username and LANGFUSE_SECRET_KEY as the password.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

Setup

  1. Create a Langfuse account: Sign up at https://cloud.langfuse.com (EU) or https://us.cloud.langfuse.com (US). The free Hobby plan is enough for testing. Self-hosting is also supported.
  2. Create project API keys: In your Langfuse project, open Settings → API Keys and create a key pair. You get a public key (pk-lf-…) and a secret key (sk-lf-…).
  3. Store the keys: Add LANGFUSE_PUBLIC_KEY=pk-lf-… and LANGFUSE_SECRET_KEY=sk-lf-… to your .env file. The API uses HTTP Basic auth with the public key as username and secret key as password.
  4. Verify access: Run the List Traces tool. If your project is in the US region, set LANGFUSE_HOST=us.cloud.langfuse.com in your .env; EU projects use the default cloud.langfuse.com.

Provider notes

  • API keys are project-scoped; create separate keys per project/environment
  • All tools send their requests to the host set in the LANGFUSE_HOST environment variable (default cloud.langfuse.com for EU); US cloud is us.cloud.langfuse.com and self-hosted deployments use their own domain
Provider API reference.

Tools

Verify the connection

Call a read tool such as langfuse__list_traces with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.