Connect your AI

Add Tephra to the AI you use. You sign in with your Obsidian account; there are no keys or settings to copy. Your AI then checks Tephra before it answers and saves what matters after.

Server URL

https://tephra.obsidian-metrics.com/mcp
Add to Claude

claude.ai, Claude Desktop and the Claude mobile apps

  1. Open Settings, then Connectors.
  2. Choose Add custom connector.
  3. Name it Tephra and paste the server URL. Choose Add.
  4. Choose Connect, sign in with your Obsidian account and choose Allow.
  5. In a chat, turn Tephra on from the tools menu. A connector added on the web also appears in Claude Desktop and mobile.

Free plans allow one custom connector. Team and Enterprise owners add it once under Organization settings, Connectors.

Add to ChatGPT

chatgpt.com and the ChatGPT apps

  1. Open Settings, then Apps (Apps & Connectors).
  2. Under Advanced settings turn on Developer mode.
  3. Choose Create app, name it Tephra, paste the server URL and choose OAuth.
  4. Sign in with your Obsidian account and choose Allow.
  5. In a chat, pick Tephra from the + menu.

Developer mode is available on Plus, Pro, Business, Enterprise and Edu plans; a workspace admin may need to allow it.

Add to VS Code (GitHub Copilot)

VS Code agent mode

Add to VS Code
  1. Tap Add to VS Code (or run MCP: Add Server, choose HTTP and paste the server URL).
  2. When VS Code asks, sign in with your Obsidian account and choose Allow.
  3. Open Copilot Chat in Agent mode; Tephra's tools are listed under the tools button.
Add to Cursor

Cursor

Add to Cursor
  1. Tap Add to Cursor and confirm Install.
  2. In Settings, MCP, choose Login (or Connect) next to tephra, sign in with your Obsidian account and choose Allow.
Add to Claude Code

the terminal

claude mcp add --transport http tephra https://tephra.obsidian-metrics.com/mcp
  1. Run the command below.
  2. Start claude, type /mcp, pick tephra and choose Authenticate; sign in and choose Allow.
Add to Gemini CLI

the terminal

gemini mcp add --transport http tephra https://tephra.obsidian-metrics.com/mcp
  1. Run the command below.
  2. Start gemini and type /mcp auth tephra; sign in and choose Allow.
Add to Windsurf

Windsurf (Cascade)

  1. Open Cascade, then the MCP servers panel, then Add custom server (mcp_config.json).
  2. Add: "tephra": { "serverUrl": "https://tephra.obsidian-metrics.com/mcp" } and save.
  3. Sign in with your Obsidian account when Windsurf asks.
Add to Zed

Zed's agent panel

  1. Open the agent panel settings, then Add Custom Server.
  2. Paste the server URL as a remote server named tephra.
  3. Sign in with your Obsidian account when Zed asks.
Add to Mistral Le Chat

chat.mistral.ai

  1. Open Intelligence, then Connectors, then Add connector, Custom MCP connector.
  2. Name it Tephra, paste the server URL and choose OAuth.
  3. Sign in with your Obsidian account and choose Allow.
Add to Perplexity

Perplexity

  1. Open Settings, then Connectors, and add a custom remote connector if your plan offers one.
  2. Paste the server URL, sign in with your Obsidian account and choose Allow.
Add to Any other MCP app

any app that can add a remote MCP server

  1. Add a remote (HTTP / Streamable HTTP) MCP server and paste the server URL.
  2. Choose OAuth if asked. Sign in with your Obsidian account and choose Allow.
  3. If the app has no OAuth sign-in, use an AI key instead (Advanced, below).

Connected apps

Sign in to Tephra in this browser to see the apps you connected.

Advanced: AI keys

For tools that cannot sign in with OAuth, create a personal AI key in the Tephra app under Connect your AI and send it as Authorization: Bearer tpk_....