본문으로 건너뛰기
cccskills
무료GitHub에 공개

mcp-setup-and-debug

Configure and debug MCP servers for OpenCode, Codex CLI, and Claude Code, including auth headers, scope, and validation checks. Use when MCP tools fail to connect or when adding a new MCP server.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Chronote-gg/Chronote
설치 방법 보기

포함된 파일(1)

  • SKILL.md2.4 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

MCP Setup And Debug

Overview

Add or fix MCP server configs across OpenCode, Codex, and Claude Code. Confirm endpoints, auth headers, scopes, and validate with each client command.

Workflow

1) Confirm endpoints and auth requirements

  • Identify the MCP endpoint and transport. For Langfuse Prompt MCP (US) use https://us.cloud.langfuse.com/api/public/mcp with Basic auth. For Langfuse Docs MCP use https://langfuse.com/api/mcp with no auth.
  • Use web search to verify URLs and required headers if unsure.

2) Prepare auth header (when required)

  • Use LANGFUSE_PUBLIC_KEY and LANGFUSE_SECRET_KEY in .env.local, then run node scripts/setup-langfuse-mcp-auth.js to generate .opencode/langfuse.mcp.auth, .opencode/langfuse.public, and .opencode/langfuse.secret for OpenCode.
  • Codex and Claude Code still expect LANGFUSE_MCP_AUTH in the environment.
  • Keep credentials out of repo files.

3) Configure each client

  • OpenCode: add a remote MCP server in opencode.json under mcp.
    • Include headers and set oauth to false for API key based servers.
    • For local MCP servers that run via uvx, use type: "local" and command: ["uvx", "--python", "3.11", "langfuse-mcp", "--read-only", "--tools", "traces,observations"].
    • Validate with opencode mcp list.
  • Codex CLI: add entries in .codex/config.toml or ~/.codex/config.toml.
    • For HTTP servers, use env_http_headers to pull LANGFUSE_MCP_AUTH from the environment.
    • Validate with codex mcp list and the /mcp slash command in the TUI.
  • Claude Code: add entries in .mcp.json or use claude mcp add --transport http.
    • Validate with claude mcp list and the /mcp slash command inside Claude Code.

4) Debug checklist

  • 401 Unauthorized usually means the auth header is missing or malformed.
  • HTML or 404 responses often mean the URL is wrong or OAuth was attempted on a non OAuth server.
  • For OpenCode, set oauth: false when using API keys.
  • Confirm environment variables are available to the client process.

5) Report status

  • Summarize which clients connect and which fail.
  • Provide the exact error text for each failing client and propose the next fix.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

chronote-product-analytics

무료

Analyze Chronote product adoption with PostHog and Langfuse, including active users, meetings, feature usage, AI telemetry, and privacy-safe resolution of active Discord guild IDs to live server names.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Chronote-gg/Chronote42026년 10월 19일 업데이트

docs-authoring

무료

Use when a change affects user-visible behavior at docs.chronote.gg and needs public documentation. Covers where docs live (apps/docs-site vs docs/), authoring checklist, yarn docs:check, and Algolia config. Trigger when the user mentions docs, release notes, what's-new, or user-facing PR changes.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Chronote-gg/Chronote42026년 10월 19일 업데이트

investigate-and-plan

무료

Investigate errors, incidents, or product ideas using both internet research and repo-wide codebase research, then propose a concrete changeset plan with clarifying questions before any implementation. Use when a user asks to investigate, root-cause, or plan changes, or when an Issue or PR is referenced and needs a plan.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Chronote-gg/Chronote42026년 10월 19일 업데이트

langfuse-metrics

무료

Query aggregate Langfuse cost, volume, latency, and model telemetry efficiently with Metrics API v2. Use for dashboards, rollout checks, usage summaries, and cost or latency comparisons; use Observations API v2 instead when individual rows are actually required.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Chronote-gg/Chronote42026년 10월 19일 업데이트

mcp-setup-and-debug

무료

Configure and debug MCP servers for Claude Code, OpenCode, and Codex CLI, including auth headers, scope, and validation checks. Use when MCP tools fail to connect, when an MCP server returns 401/404/HTML, or when adding a new MCP server to this repo.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Chronote-gg/Chronote42026년 10월 19일 업데이트

pr-post-push-sop

무료

Use every time you push a commit to an active pull request, to verify the PR is truly stable before reporting merge readiness. Covers the post-push wait window, AI review audit (Copilot/Greptile/Codex), and the gh commands to snapshot PR state. Trigger on "I pushed" or "is the PR ready to merge".

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

Chronote-gg/Chronote42026년 10월 19일 업데이트

Chronote-gg의 스킬 모두 보기

이 스킬의 문제 신고